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INTRODUCTION 


If you use your Apple Il personal computer often enough, long enough, and 
late enough, eventually your Apple may decide to reveal “ІТ” to you. 

“IT” is a series of revelations on where we came from, where we аге, and 
where we are heading. Most often, your Apple will reveal "IT" to you very early 
on some morning in your second or third year of Apple use. 

The “ІТ” revelation is for real. Just ask anyone who has worked with an Apple 
long enough. The wry smile and knowing nod tells all. 

If my Apple will forgive me, l'd like to reveal some of the present “ІТ” 
messages to you, for they say a lot... 


The Apple II is far and away the single most powerful tool ever put in the 
hands of many individuals on an uncontrolled and unregulated basis. The new 
personal freedoms and the potential opportunities that result from this are almost 
beyond belief. It's now a whole new ball game, a jump into hyperspace from 
where we аге. The Apple II is far more significant and it will have a vastly greater 
impact than such short term frivolities as the automobile and television—and, 
possibly, even more than the printed word itself. Even time may eventually be 
measured as “ВА” and “АА,” split at that magic date in the spring of 1977. 


-вев - 


Тһе Apple experience is absolutely and totally unique. There is no other 
product available anywhere, at any price, that adapts itself as easily, as well, and 


as conveniently to whole new worlds of strongly user-oriented applications. The 
unbridled potential of Apple's sixteen МО sockets is utterly awesome. 


- 664 - 


Future historians will recognize the Apple Il as the DC-3 of һе microcomputer 
revolution. 


- ева - 


There are several reasons for Apple’s success. The first is simply being т the 
right place at the right time. The second is blind luck. But, the third and most 
important reason is that Apple has lacked "'us-versus-them." 
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Apple has always treated its users like they were friends and not the enemy. 
They didn't seal the works up, or keep you out of the system monitor, or hide 
their documentation under an armadillo somewhere, or try to prevent you from 
doing easy add-ons, enhancements, or expansions. Apple didn't force software 
people to buy an expensive development system. Instead, the Apple II itself is 
its own superb development tool. There's no fancy modules or other restraints 
that keep anyone from getting into the Apple support business. In fact, the widest 
possible number of Apple hardware and software suppliers was encouraged 
from the start. And the "our engineering department not only knows best, 
but they are God” attitude of other manufacturers is simply not there 
with Apple. 


The garbage-to-good ratio of Apple software is skyrocketing. The quantity of 
truly astoundingly atrocious Apple software is now running at least a thousand 
times ahead of the useful and reasonable stuff. And, it's getting worse. 

Garbage software fails to use the unique Apple resources to the utmost. This 
type of software may be as snotty as most of the dino stuff. It may use fancy 
packaging and/or expensive promotion to try and make up for sloppy and 
poorly thought-out coding. Garbage software is usually locked, so that the user 
cannot back up or modify the program to suit his own needs. It is usually slow 
and awkward to boot. Garbage software also usually demands oddball Codings 
and disk formats that guarantee incompatibility with everything else. 

Garbage software is caused by people who are greedy, sloppy, dumb, inex- 
perienced, in a hurry, or all five. Garbage software is not user oriented. It is 
overpriced. It has miserable error recovery. It tries to solve some small specific 
problem, rather than being a generalistic tool that can handle a broad class of 
problems. Garbage software steals the ideas of others, but can only come up 
with a second-rate result at best. It attacks problems that not only do not need 
solving, but which shouldn't be solved at all with a computer. 

Please, if you are going to write this sort of trash, go get yourself a different 
brand of personal computer. We don't need you and we definitely don't want 
you. 


Any attempt whatsoever at copy protection will hack off and inconvenience 
your legitimate users and it will dramatically increase the number of bootleg 
copies of your program in circulation. It will also price your program out of the 
market. 

A user of software demands the absolute right to make backup copies of 
everything he buys, and must have the right to examine and modify all coding 
in that software so he can meet his own needs. These are mandates. 

The big thing about copy protection is that it doesn't. A year's effort by a 
crackerjack military cryptography team can usually be undone in fifteen 
minutes, between klingon zappings, by your average fourteen-year-old. And, 
morality and economics aside, one fact stands out... . 

Undoing copy protection is fun! 

Not only is it fun, but cracking the uncopyable is about the most challenging 
and most rewarding thing that you can possibly do with your Apple. And, the 
things you learn along the way are exactly the skills that you will need to become 
a really great programmer. So, | guess we should all be thankful for the copy- 
protection people since they are giving us all this fascinating entertainment and 
superb training at an unbeatable price. 
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Today’s best and brightest Apple programmers are stumbling around іп the 
dark. Proof of this is that a program with a Peelings rating of "AA" today barely 
earns a “B” next year, and drops to a “D” or unfit-for-use “F” the next. 

Surely, by now, the message is in: it is absolutely impossible to write a great 
program in BASIC. Pascal, of course, is so bad that it is beyond the pale. Great 
programs must be written either wholly or in part in machine language so they 
can use Apple's resources to the utmost, at the fastest possible speed. Check 
Softtalk’s top thirty. At this writing, thirty out of thirty are either written totally 
in machine language or make extensive use of machine-language sequences. 

It's scary to think of what a really good programmer, who truly understands 
his Apple, will be able to do with this machine. It hasn't happened yet, but watch 
out. It is only a matter of time. 


-ввв- 


We are only now beginning to find out about some secrets of the Apple that 
everybody should have known about way back in 1977. For instance, we know 
now that we can have many different fonts of upper- and lower-case characters 
without using special hardware. We know that we can easily do an 80-character 
line with zero additional hardware, and that lines above a hundred characters 
are possible. We know that it is easy to quadruple the HIRES virtual resolution 
of the Apple. 

We know, of course, that there are hundreds of colors available either in 
HIRES (high resolution) or LORES (low resolution). We also know that we can 
mix and match HIRES, LORES, and text anyway that we like—anywhere on the 
screen. We know that we can do an exact, jitter-free, software lock to video 
timing for video wipes and precision light pens. Once again, these require no 
special hardware. And, of course, we know we can gently and legibly scroll the 
characters up the screen. We know that the early graphics mappings were much 
slower than necessary. And, we know our Apple can directly interface robotics 
and appliance controls—again, without special hardware. 

The big question is: "How much don't we know that we should have known 
back in 1977?" 


660646 


This Enhancing Your Apple II series is intending to try and bring everybody 
up to 1977. We want to try and understand what we really have in the Apple 
|, and what its real capabilities and limits are. 

Each enhancement is designed to show you something about some small 
corner of your Apple. While a typical enhancement will combine some simple 
new hardware with a machine-language driver or two, just about anything at all 
is likely to crop up. We have tried to mix simple and advanced enhancements 
together, so there will be something here for you, regardless of how much Apple 
experience and expertise you now have. 

We also have “unbundled” everything for your convenience and cost savings. 
Each enhancement is in four pieces. The first part of an enhancement is the 
complete story and listings here in this volume. Secondly, there is a companion 
diskette you can order using one of the cards in the back of the book. This 
diskette includes copies of all the code used in this volume and more. Machine- 
language codings include full source documentation under both EDASM and the 
S-assembler while BASIC Programs include full documentation. Naturally, you 
are free to copy, adapt, and modify this standard DOS 3.3 diskette to your heart’s 
content, so long as you do so only for your own use. 
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Thirdly, there is a parts kit you can order that includes everything you will 
need to make all of the hardware modifications involving all the enhancements 
in the entire book. Lastly, and most important, there is also a feedback card. This 
card is needed for your participation in some of the enhancements. It also 
registers your name for updates and corrections, and it "closes the loop” so we 
can offer the best possible Apple enhancements in future volumes. 

Should you be interested, we will add an on-line update and bulletin board 
service to this feedback process. Let us know if you have a modem and want 
to participate. 

Taking a quick look at this volume, we start out with a pair of simple g/ompers 
that anyone can build. These solve completely the video changeover-switch 
hassles that you might have when using an rf modulator. Enhancement 2 is a 
software color killer. A plug-in reversible hardware mod lets you eliminate all 
color fringes from black and white high resolution (HIRES) displays under soft- 
ware control. You can now combine color and black and white displays in the 
same program without any set adjustments. 

The real heavy of this volume is Enhancement 3. Here we find a method for 
tearing apart someone else’s machine-language program that is astonishingly fast 
and super easy. It may take you years to fully explore and fully comprehend the 
implications of this single enhancement. 

Another heavy appears in Enhancement 4. We add a lone wire here to give 
you a way to exactly lock your programs to video timing. And, we mean exact. 
The locking is done jitter free, which opens up bunches of new applications, 
such as video wipes and precision hardware-free light pens. 

Want to mix and match HIRES, LORES, and text anywhere on your Apple 
screen? This is trivially easy once you master Enhancement 5. We also see how 
to tap the hundreds of available LORES colors in this enhancement. A compan- 
ion hardware mod called a glitch stomper appears as Enhancement 6. This one 
makes displays that switch modes on screen operate even better. 

How about a gentle scroll, where the characters move smoothly up the screen 
rather than jumping up illegibly like they do now? This one's done in Enhance- 
ment 7. It’s super smooth, and completely glitch free. The final enhancement 
in this volume shows us how to pick up hundreds of different HIRES background 
colors, and how to put them down seven times faster than you might think 
possible. 

That's about it for Volume 1. But, we have some really great stuff on tap for 
future volumes. A sneak preview appears at the end of this volume. This series 
is open-ended. As long as there are new things to learn about your Apple? and 
new ways to do them, we will try and show you how to do them. 

Oh, yes. Some legal beagle somewhere will probably get bent out of shape 
if | don't tell you that Apple is a registered trademark of some outfit in California 
whose name | don't recall just now, and that everything here is pretty much my 
own doing, and is done without Apple's knowledge or consent. 


DON LANCASTER 
Summer 1982 


This book is dedicated to “IT” 


Enhancement 


TWO GLOMPERS 


Here’s two different ways to elimi- 
nate the hassles caused by the 
changeover switches оп rf 
modulators. One glomper is porta- 
ble. The other is more or less per- 
manent. 


TWO GLOMPERS 


Have you ever been infuriated by that #$%# & changeover switch on your 
Apple’s rf modulator? 

If you can find a flat place to stick it on the back of your tv, it’s stuck there 
for good. If you can't, the switch quickly does а Kamakaz act, strangling itself 
on its own leads. And, this switch is very difficult and inconvenient to move from 
tv to tv. 

This changeover switch is totally useless. It doesn’t even do what it is intended 
to do, since you can easily leave a built-in antenna in place and radiate your 
video all over everywhere. 

Here are two much saner antenna g/ompers that you can use instead. Either 
glomper version will quickly and easily fit any tv. They are cheap and simple 
enough that you can build lots of them. 


II 
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Most rf modulators provide a phono plug input to the changeover switch. This 
phono plug fits a standard RCA phono jack. Both glompers start with an RCA 
phono jack and adapt it so that it is super easy to connect to your tv. 

Our glomper of the first kind is shown in Fig 1-1. This one mounts a phono 
jack on a clothespin tv antenna connector. This style glomper is best when you 
are using your Apple on lots of different tv sets at different times, or if you want 
to quickly switch between sets. 


Glomper of the first kind is made from a phono 
jack and a clothespin connector. Use it if you 
often change or test different tv's. 


Fig. 1-1. A glomper of the first kind. 


The glomper of the first kind is also very useful if you are buying a color tv 
and want to take your Apple to the store in order to compare lots of models to 
see which handles Apple video the best. 

Here are the parts you will need for a glomper of the first kind . . . . 


PARTS LIST FOR A 
GLOMPER OF THE FIRST 
KIND 


( ) Clothespin-style tv 
antenna connector. 


( ) RCA phono jack, 


vertical pc-mount style. 


( ) No. 22 stranded 
hookup wire, insulated, 
2 inches long. 

( ) Solder flux (optional). 


( ) Short piece of 
electronic solder. 


And here is how to build опе... . 
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INSTRUCTIONS FOR BUILDING A 
GLOMPER OF THE FIRST KIND 


1. Try to fit a RCA upright рс phono jack to the two holes in the 
clothespin antenna connector as shown. One hole is in the 
metal and one is in the plastic. 


If the center connection of the phono jack interferes with the 
plastic handle, remove some of the plastic as shown. Use a 
knife, a file, or simply melt the plastic with a soldering iron as 
needed. 


2. Strip 1/4 inch of insulation from both ends of a 2-inch-long 
piece of No. 22 stranded wire. 


Solder one end of this wire to the center conductor of the 
phono jack. Make sure the phono plug fits after soldering. 


3. Carefully and throughly clean both the phono jack and the 
clothespin connector at the point where they are to be 
soldered together. Add a drop of super-safe electronic solder 
flux if it is available. 


Solder the phono jack to the antenna clothespin connector as 
shown. Use a soldering gun or a medium (100 watt) soldering 
iron. 


4. Gently crimp the unsoldered ear of the phono jack against 
the plastic of the clothespin connector. 


GENTLY Be sure the jack has cooled before you do this. 


5. Carefully clean the other side of the clothespin connector. 
Add a drop of super-safe solder flux if it is available. 


SOLDER 


leer Solder the free end of the stranded wire to this side of the 


clothespin connector. 


6. Flex the clothespin a few times to be sure it works smoothly. 
Remove any remaining solder flux. 


gue WHE ВЕ SURE 
а? ТО МАТСН This completes your assembly. 
— UHF TO UHF 
BST | УНЕ ТО УНЕ 7. To use your glomper, plug the рт plug on the rf modulator 
SN cable into the jack on the glomper, and clip the glomper on the 


proper antenna terminals. 


ALWAYS REMOVE ALL OTHER OUTSIDE AND INTERNAL 


P ss ANTENNA CONNECTIONS WHEN USING THIS GLOMPER! 


RF MODULATOR | 


Fig. 1-2. How to build a glomper of the first kind. 
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Using these tools . . . . 


TOOLS NEEDED TO BUILD 
EITHER STYLE GLOMPER 


( ) Needle nose pliers 


( ) Diagonal-cutting pliers 
( ) Wire stripper 


( ) Soldering gun or 
medium soldering iron 


( ) Ink eraser or steel wool 


( ) Terminal сптрег 
(optional) 


( ) Small vise or clamp 


Construction details are shown in Fig. 1-2. You mount the phono jack on the 
plastic handle of the clothespin connector. Be sure to use a stranded wire 
between the center of the phono jack and the other arm of the clothespin. Solid 
hookup wire will soon break if you flex it too often. 

You will also want to carefully clean both the phono jack and the clothespin 
connector before soldering. This can be done with an ink eraser or steel wool. 
If you have some, a drop of "'super-safe"' electronic solder flux will make things 
much easier. Do NOT use any other type of flux! 


Glomper of the second kind is made from a phono 
jack and spade lugs. Use this glomper for more 
permanent connections. 


Fig. 1-3. A glomper of the second kind. 
Our glomper of the second kind is shown in Fig. 1-3. This one is designed to 


be permanently connected to a tv. It is nothing but an RCA phono jack and two 
stranded wires ending in spade lugs. Here's the parts you will need . . . . 


PARTS LIST FOR A 
GLOMPER OF THE SECOND 
KIND 


( ) RCA phono jack, ( ) No. 22 stranded 


vertical pc-mount style. hookup wire, insulated, 
5 inches long. 


( ) Crimp-on spade lugs (2 


needed). ( ) Short piece of 


( ) Solder flux (optional). electronic solder. 


STRIP, CRIMP, 
AND SOLDER 


w CLEAN, CRIMP, 


SOLDER 


AND SOLDER 


CABLE FROM 
RF MODULATOR 


BE SURE 
TO MATCH 
UHF TO UHF 

OR 


VHF TO VHF 
(SUP-R-MOD IS A 
UHF MODULATOR) 
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INSTRUCTIONS FOR BUILDING A 
GLOMPER OF THE SECOND KIND 


1. Cut two pieces of Мо. 22 stranded hookup wire 2% inches 
long and strip % inch of insulation from each end. 


Crimp and then solder one spade lug to one end of each wire. 


2. Carefully polish the inside of one leg of an upright pc phono 
jack. Then roll this leg over onto the free end of one of the wires. 


Add a drop of super-safe solder flux if available and solder wire 
to jack as shown. 


3. Solder the free end of the remaining wire to the center con- 
ductor of the phono jack. 


4. Carefully inspect the wiring to be sure there is no short bet- 
ween the outside and the inside of the phono jack. 


You might like to bend the remaining leg of the phono jack in- 
ward for better appearance. 


5. Twist the two leads together four or five times and arrange the 
lugs as shown. 


This completes your assembly. 

6. To use your glomper, connect the spade lugs to the tv’s 
antenna terminals. Plug the pin plug on the rf modulator cable 
into the jack on the glomper. 


ALWAYS REMOVE ALL OTHER OUTSIDE AND INTERNAL 
ANTENNA CONNECTIONS WHEN USING THIS GLOMPER! 


Fig. 1-4. How to build a glomper of the second kind. 


Complete construction details are shown in Fig. 1-4. Again, be sure to use 
stranded wire, carefully clean before soldering, and use a drop of "'super-safe'' 
flux, if you have it available. 

If you have several of your own tv sets in use, put a glomper of the second 
kind on each one. 

Be sure to connect the output of a uhf rf modulator (such as the SUP-R-MOD) 
to the uhf antenna terminals, or the output of a vhf modulator (some others) to 
the vhf antenna terminals. 

Note also that there are two RCA jacks on the SUP-R-MOD. The one you 
want goes down into the rectangular shielded box. The other one is not normally 
used and does notoutput any rf signal. It pays to label these two jacks “RF OUT" 
and "VIDEO THRU” by writing on the inside wall of your Apple with a Sharpie 
or similar heavy pen. 
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Regardless of which style glomper you use, please obey this ге.... 


DO NOT EVER CONNECT THE RF 
OUTPUT OF AN APPLE SYSTEM 
TO A BUILT-IN ANTENNA, AN 


OUTDOOR ANTENNA, OR A 
CABLE TV LINE. 


If you are using both an outside antenna and а glomper, you should put the 
outside antenna line on а clothespin connector as well. If you have cable service, 
always unscrew the cable connector before using your Apple. 

A glomper of either style must be used with an rf modulator. Just because the 
Apple's baseband video output jack is also a phono jack, don't expect any useful 
results if you try to feed raw video into the antenna terminals of a tv set. While 
you might actually get something on the low channels if you try this, in no way 
will the display be stable or useful. 

There is one other minor use for your glompers. Many of the music synthesiz- 
er cards output via a phono jack but can directly drive a speaker. If your speaker 
enclosure has a pair of screw terminals on the back, just use either style glomper 
to get from the music card to the speaker % 


A complete set of all parts needed 
to build two glompers of each 


style is included in the companion 
parts kit to this volume. 


Enhancement 


PROGRAMMABLE 
COLOR KILLER 


A simple, cheap, and reversible 
hardware modification that elimi- 
nates color fringes on text and 
removes unwanted color lines in 
HIRES displays. You now have a 
choice of black and white or color 
display under program control. 


PROGRAMMABLE COLOR KILLER 


Did you ever wish that you could eliminate those color fringes on Apple's 
HIRES text displays? Or, be able to get rid of the vertical color lines that some- 
times mess up an otherwise stunning white-on-black HIRES display? Or, be able 
to do LORES special effects, where you switch from colors to grey patterns and 
back again? 

Well, it’s going to cost you. Around $1.10 and 15 minutes of your time. 

If both of these are within your budget, you can easily add your own software- 
controlled co/or killer. The mod will work on any but the oldest revision “0” 
Apples, and if you are careful, it will be completely reversible and wan't void 
your warranty. 

After the mod is completed, a single command inside your program can give 
you a choice of color or true black and white displays on your color tv or color 
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monitor. The software control commands are either а simple РОКЕ or a ВП test 

and may be done in any language. The color killer shuts off on an autostart reset 

and stays disabled until you activate it, so it stays invisible until you want it. 
Let’s do it. 


What is a color killer? 


All color television sets have a built-in circuit called a co/or killer. The color 
killer decides whether the program material is being received in black and white 
or full color. If it is receiving a black and white signal, then the color decoding 
circuits are turned off. This keeps annoying color lines, snow, and fringes out of 
black and white program material. 

Fig. 2-1 shows us how the color killer inside your color tv works, In a typical 
color video signal, either from a tv station or from your Apple computer, there 
is a color burst following each horizontal sync pulse. This color burst usually 
consists of 8 cycles of a 3.58-megahertz sine wave. When present, the color 
burst is used to provide a reference for use by the color decoding circuitry 
inside the television. This arrangement lets the circuitry tell one color from 
another. 


COLOR PROGRAM 
ж” VIDEO 
tn a typical color signa!, a color burst is provided 
on the "back porch" of the horizontal sync pulse. 
This burst provides a color reference and deac- 
tivates the color killer, allowing a color display. 


NO COLOR 
BURST 


PROGRAM 
же” VIDEO 


In black and white video, the color burst is absent. 
This activates the color killer in a color set and 
switches to a black and white only display, 


Fig. 2-1. How the color killer, which is present in all color sets, can tell color 
from b/w video. 


The color killer looks for these bursts, and if it doesn't find them, it defeats 
the color processing so that the set displays a black and white picture with no 
color fringes. If the burst is present, the color killer lets the color processing 
circuits do their thing, and you get a full color display. 

Unfortunately for us, the color killer in your set is rather slow. It takes a fraction 
of a second for it to work. The reason for this is that in a fringe reception area 
where you get a weak or snowy picture, a color killer too fast or too sensitive 
would continuously switch from black and white to color and back again as the 
signal quality varied. This would really foul things up. 

What this means is that, as Apple people, we can only expect a color killer 
to be on or off. We can't expect it to switch back and forth during a single field 
to give us, say, full-color mixed graphics with a true black and white four-line 
message on the bottom. This we cannot do. But we can easily switch from black 
and white to full color, and back again, anytime we are willing to have the entire 
screen be one or the other. 
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The modification 


As Fig. 2-2 shows us, all but the earliest Apples have an automatic color killer 
circuit built into them. This circuit (Fig. 2-2A) consists of a 2N3904 transistor 
(Q6) and a 4.7K resistor (R27). Whenever you are in the full text mode, the point 
driving the 4.7K resistor goes positive, which turns Q6 ON, which shorts out the 
color-trimming circuit. The short, in turn, eliminates the color burst from the 
output. In anything but the full text mode, the point driving the 4.7K resistor goes 
low, which turns transistor Q6 OFF, allowing full color. 

This existing hardware color killer on your Apple works well with most better- 
grade color tv's, but it only works on full text displays done the “old” way. It 
will not work on a text display on either HIRES page or on mixed graphics. Nor 
will it work on a HIRES graphics display that is supposed to be all black and 
white. Nor can it work on a LORES display. 

Fig. 2-2B shows us how to add one resistor to give us software-controlled 
color killing. We add a second 4.7K resistor so that it also goes to the base of 
transistor Q6. This resistor comes from the source of ANT. Make ANT high, and 
you kill the burst and get true black and white displays. Make AN1 low, and you 
get full color on everything but text displays. 


COLOR 
12 RS TRIM R6 


Q6 
4 
(А) Color killer circuit. Е14 et itd KILLER 
Existing color killer circuit in your Apple works only 
in fult text mode. 
COLOR 
RS TRIM R6 
12 m 
B12 


(B) Circuit modification. 


Q6 
COLOR KILLER 
2N3904 


|= 


F14 


New resistor gives you software-controlled color. 


Fig. 2-2. А single resistor is all you need to add a software color killer. 


20 Enhancement 2 


Rather than grab AN1 at the game paddle, we get it from its source, pin 10 
of F14. This prevents accidental pull-outs when the game paddles are removed. 

The autostart ROM always drives AN1 /owon a cold start reset. This makes 
the color killer invisible until used. Note that there are errors in some early Apple 
reference manuals involving what happens during a cold autostart reset. | have 
found that what really happens is that ANO and AN1 go /owand AN2 and AN3 
go high on a cold autostart reset. You should correct pages 36 and 143 of your 
Apple reference manual if they do not agree with this. 

Logically, this is a Nor circuit because switching to the text screen OR turning 
annunciator AN1 ON activates the color killer and puts the colors OFF. 


Building it 


Here's the parts you'll need... . 


PARTS LIST FOR 
SOFTWARE COLOR KILLER 


( ) 16-contact quality DIP 
socket, machined-pin 
style. 


( ) Pin from machined-pin 
DIP socket. 


( ) 4.7K, 1/4-watt resistor 
(yellow-violet-red). 


( ) Short piece of 
electronic solder. 


And, here are the tools you will need... . 


TOOLS NEEDED TO BUILD 
SOFTWARE COLOR KILLER 


( ) Needle nose pliers 

( ) Diagonal-cutting pliers 

( ) Wire stripper 

( ) Small soldering iron, 35 
watt 

( ) Any old 14- or 16-pin 
DIP integrated circuit 


( ) Small vise or clamp 


Fig. 2-3 shows us the area of the Apple's board that we are going to work with. 
The color killer transistor Q6 is located above integrated circuits F13 and F14. 


Programmable Color Killer 21 


(1) ADAPTER MADE FROM 
PREMIUM DIP SOCKET APPLE II 
GOES IN F14. MAIN BOARD 


(©) РІМ 10 OF ADAPTER (S) EXISTING 9334 


CONNECTS TO Q6 OR 7418259 
END OF R27 THRU REPLUGS 

NEW 4.7K SERIES INTO ADAPTER 
RESISTOR 


Fig. 2-3. Pictorial shows color killer hardware additions. Single pin socket at Q6 allows 
easy removal. 


See the APPLE board parts locations sidebar located at the end of this en- 
hancement for more details on how to locate a part on your Apple's main circuit 
board. There is a grid numbered from 1 to 14 across the bottom, and lettered 
A through К up the left-hand side. Letters “С” and “1” are omitted to save on 
confusion. Location “F14” is the place where the “F” row and the “14” column 
cross. Note that F14 is NOT the fourteenth component in that row. Some ICs 
are larger than others and other locations may not be used at all. Only the grid 
location counts. Note that the numbers across the top of the circuit board (not 
shown) refer to the 1/О slots and have nothing to do with the grid. Note also 
that there are other resistors and transistors elsewhere on the circuit board. 
These have nothing to do with the color killer and must not be altered. 

Your mod consists of adding an adapter socket to F14 that routes a 4.7K 
resistor from АМТ to a new single-contact jack added to the transistor end of 
R27. Fig. 2-4 gives the assembly details. Be absolutely certain you are using a 
premium 16-pin DIP socket with machined-pin contacts. These may safely be 
plugged into another DIP socket without damage. Also, be certain to keep all 
solder off of the actual part of the pins that must fit the socket at F14, and be 
careful not to melt the plastic part of the socket. 

Should you ever want to undo the color killer, just reverse the above proce- 
dure. If you ever need some warranty repair, carefully untack the single pin 
socket as well, and clean up any remaining solder with a solder sucker or 
desoldering braid. Strictly speaking, the mod does void your warranty, but you 
can easily disguise the fact that it ever was made. 

Always be careful when you insert or remove anything. See that the color 
killer mod stays in place. А dab of hot glue, silicon rubber, or other "semi- 
permanent” sticky stuff might be a good idea here to hold the killer socket to 
the pc board. Be careful, of course, to keep any gunk out of the socket pins. 

Note that a cold start RESET using the autostart monitor will also turn the color 
killer off, but that an autostart RESET to some BASIC program usually will not. 
Thus, the color killer will normally come up as OFF if you don't mess with it, 
just like it wasn't there. 
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Here's how to install your software color killer . . . 


INSTALLING THE 
SOFTWARE COLOR KILLER 


. Turn the power off and 
unplug both ends of the 
Apple power cord. 


. Remove the 7415259 ог 
9334 integrated circuit 
at F14, using an IC 
puller if you have one 
available. 


. Plug the 7415259 or 
9334 into the color 
killer’s 16-pin socket. Be 
sure the notches on 
both the socket and the 
IC point in the same 
direction. 


4. Plug the color killer 5 


16-pin socket into the 
Apple mainframe at 
F14. Be sure that the 
resistor points away 
from you and that the 
notch on both socket 
and IC points towards 
the keyboard. 


. Plug the floating resistor 


lead into the single 
contact socket at R27, 
using needle-nose pliers. 


. Reconnect the power 


cord and apply power. 
Run the COLOR KILLER 
DEMO program for 
checkout. 


INSTRUCTIONS FOR BUILDING 
COLOR KILLER 


1 
4 
ч 


1. Take a single ріп from а machined-contact socket and bend ee. 


it as shown. If you destroy a socket to get one of these pins, 
melt the pins out rather than stressing them. 


Plug the 4.7K resistor into the single pin socket as a temporary 
"handle." Then, tin only the bent part of the socket by applying 
a very small amount of solder. 


Do NOT solder the resistor to the socket! 


2. Find the end of resistor R27 nearest Q6 on the Apple main 
board and tin the lead of R27 here by applying a small amount 
of solder. 


NOT HERE! 


Fig. 2-4. How to build your color killer. 


РМ 10 


DUMMY IC 


SOLDER 


BEND DOWN 30° 
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Then, reflow solder the “tail” of the single pin socket to the Q6 
end of resistor R27. The tail should point towards the 
keyboard. 


Remove the resistor “handle” after the solder cools. 


3. Plug any old nonvaluable 16-pin DIP integrated circuit into 
the 16-pin machined-contact pin socket. This will keep the con- 
tacts aligned should the plastic soften. 


Identify pin 10 by inking the plastic. 


Note that this MUST be the type of premium socket that has 
small machined-pin contacts that are safe to plug into another 
socket. 


Secure the socket in a small vise. 


4. Cut both leads of the new 4.7K resistor to 7/16 inch length. 
Form a bend and a loop in one resistor lead as shown. Secure 
the resistor in this position against the socket somehow. 


Solder the resistor loop to pin 10 of the socket, EXACTLY as 
shown. 


Be sure that no solder gets onto the part of the pin that must 
plug into the Apple, and that there are no shorts to adjacent 
pins 9 and 11. 


5. Remove the nonvaluable IC and set it aside and out of sight. 


Position the socket as shown. Then bend the remaining 
resistor lead downward as shown. 


This completes the assembly. 


Refer to the text for installation and checkout. 


Fig. 2-4 Cont. How to build your color killer. 
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Here's how you use your software color killer . . . 


USING THE 
SOFTWARE COLOR KILLER 


From machine language — 
ВП $CO5B turns killer ON 


ВП $COSA turns killer OFF 
From either BASIC — 


POKE —16293,0 turns killer ON 
POKE —16294,0 turns killer OFF 


There could possibly be a conflict between the color killer and anything else 
that is plugged into the game socket that uses AN1 as an output. Note that there 
would be no conflict on a text display or on a display routed to a black and white 
monitor. There may not be a conflict if the other use of ANT is brief or rare, or 
if it takes place in the text mode. Naturally, if you must have AN1 for a conflict- 
ing use, you can always remove the socket and its resistor. 

While a ВП test is the most “proper” way of switching AN1 from machine 
language, any old mode that addresses these locations, such as LDA %С05В or 
т 290206 may be used. 

ut... . 


Do NOT disconnect the color killer 
resistor without removing the DIP socket! 


A floating resistor lead can cause damage 
if it happens to hit anything. 


Program 2-1 is an Applesoft demo program that makes a pretty HIRES picture 
for you and alternately switches the color killer OFF and ON every few seconds. 
Watch particularly the effect on the slightly slanted lines in the middle of the 
image and the color fringing on the mixed graphics. Besides the Applesoft 
language, Program 2-1 needs the color killer hardware modification as described 
in this enhancement. 

If you hand load this program, be sure to include the space following the 
"ON" in line 450. Note also that a color killer ON should give you black and 
white and a color killer OFF should give you a full color display. 

You can use this demo to test your programmable color killer. The program 
works by first setting up a HIRES picture in the mixed graphics mode and adding 
some color blocks. Then, it turns the color killer OFF by poking AN1 to a zero, 
and writing the word “OFF” to the text area. It then delays for a few seconds, 
pokes AN1 to a one, and writes the word “ОМ,” The process keeps repeating 
till you end the program with a CTRL-C or a RESET. 

Some very old, cheap, or otherwise scungy color tv sets may ignore the color 
burst and do their color killing based on whether there is lots of energy in the 
“color band.” Since Apple a/ways has lots of energy in the “color band," these 
sets will ignore any color killing commands. On a set like this, the old hardware 
color killer won't work either. On these sets, you are stuck with the old method 
of manually backing all the color controls off. 
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PROGRAM 2-1 
COLOR KILLER DEMO 


LANGUAGE: APPLESOFT NEEDS: COLOR KILLER HARDWARE 
MOD OF ENHANCEMENT #2 


REEKKKKKKKKEKKKEKKKKEKE 


COLOR KILLER 
DEMO 


VERSION 1.0 
(11-4-81) 


COPYRIGHT 1981 
BY DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


3 f ЛЕ & + ЛЕ ЛЕ ЛЕ ЛЕ ЛЕ ЛЕ ЛЕ ЛЕ: 


REKKKKEKKKKKKKKKKKKK 


COLOR KILLER DESCRIBED 
IN ENHANCING YOUR 
APPLE II, VOLUME I. 


HOME-: REM CLEAR SCREEN 

HGR : REM HIRES ON 

РОКЕ - 16301,0: REM MIX GR 
APHICS 


HCOLOR= 3: REM DRAW WHITE 


HPLOT 70,40 TO 120,40 TO 123 
‚110 TO 168,110 TO 171,40 ТО 
221,40 TO 221,140 TO 70,140 TO 
70,40: REM DRAW FIGURE 


HCOLOR= 90:У 58: GOSUB 
500 

HCOLOR= 90:V = 115: GOSUB 
500 

HCOLOR= 190: GOSUB 500 
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PROGRAM 2-1, СОМТ'О... 


330 HCOLOR= 7:V 86: GOSUB 500 

340 HCOLOR= 6:У 58: GOSUB 500 

350 НСОҺОВ- 3: HPLOT 90,86 ТО 99 
,86 ТО 99,96 ТО 90,96 ТО 90, 
87 

360 REM DRAWS SIX COLOR BLOCKS 


VTAB 21: HTAB 12: PRINT "COL 
OR KILLER IS ";: REM PRINT 
MESSAGE 


POKE - 16294,0: REM TURN K 
ILLER OPF 


NORMAL : HTAB 28: PRINT "OFF 
";: REM TEXT 


РОК М = 0 TO 6000: NEXT : REM 
STALL 5 SECONDS 


POKE - 16293,0: REM TURN K 
ILLER ON 


INVERSE : HTAB 28: PRINT " O 
М ";: NORMAL : REM TEXT 


FOR М = 0 ТО 6000: NEXT : REM 
STALL 5 SECONDS 


IF PEEK ( - 16384) » 127 THEN 
POKE - 16368,0: PRINT : PRINT 
"RUN MENU": REM EXIT ON KP 


REM REPLACE :PRINT: WITH 
:END IN 465 IF AUTO MENU IS 
NOT IN USE. 


GOTO 410: REM DO IT AGAIN 


FOR N = 0 TO 9 

HPLOT H,(V +N) TO (H + 10), 
(у + N) 

NEXT : RETURN : REM SUB TO 
DRAW BOXES 
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APPLE BOARD PARTS LOCATIONS 


Parts are located on the Apple main circuit board by use of a grid system... . 
ШО CONNECTORS ARE 


(RF MODULATOR) 


>| 
= 
а 
а 
= 
о | 
a [1 
4 
el 
= 


(KEYBOARD) — 


There are fourteen columns in the grid numbered from 1 to 14. Each numbered column goes 
from front to back. There are nine rows in the grid lettered from A to K. Each lettered row goes 
from left to right. Letters G and | are omitted to prevent mixups. 

An integrated circuit, or IC, is located by finding the grid crossing that it is nearest to. If the IC 
is a big one, the /owest grid crossing number is used as the location. 

For instance, the game paddle is located at 14. The 6502 microprocessor is said to be lo- 
cated at H6, although it also takes up grid locations H7, H8, and H9. 

If the Apple is still in the case, you cannot see the grid numbers that run from left to right since 
these are at the front of the circuit board under the keyboard. Instead, use row “С” and count the 
fourteen integrated circuits from left to right. Integrated circuit C1 is a 74LS153, while integ- 
rated circuit C14 is а 741532. 

Note that not all rows are completely filled, and that some ICs are bigger than others. Thus, 
the IC in grid location F14, which is a 74LS259 or a 9334, is only the tenth or eleventh device 
from the left, depending on the version of your Apple. 

Note also that the row of numbers along the top of the board are the slot numbers for the /O 
sockets and have nothing to do with the grid callouts. 


REMEMBER—To find a given location, count GRID POSITIONS and not devices. 
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Our new software color killer only kills the color subcarrier at one point in 
the circuit, unlike Revision 7 and later Apple versions whose hardware color 
killer nails the subcarrier twice. Thus, the software color killer may be slightly 
more sensitive to the control settings. 

If you get some brief color flashes during the OFF times on a better grade set, 
this usually means the auto-color circuitry in the tv is Aunting. Try backing the 
color controls off slightly or turning the auto-color switch on the tv OFF if this 
happens. Usually, a careful adjustment of controls and a touchup of the rf 
modulator video level at the Apple will completely eliminate any color flashing. 
On any reasonable set, you should get your choice of continuous color or 
continuous black and white, after some initial adjusting % 


The Applesoft program SOFTWARE 
COLOR KILLER DEMO is included 
in the companion diskette to this 
volume. 

The program is fully copyable. 


A complete set of all parts needed 
to build one color killer modifica- 
tion is included in the companion 

parts kit to this volume. 


Епһапсетепі 


ТЕАКІМС ІМТО 
MACHINE-LANGUAGE CODE 


This method of breaking down and 
understanding someone else's 
Apple 11 machine-language pro- 
gram is — to say the least — 
unique. Here are complete details 
on how to rapidly "crack" both 
the form and function of any tough 
program. It takes only one-tenth 
of the time of orthodox methods. 


TEARING INTO MACHINE-LANGUAGE CODE 


Check into the top thirty Apple programs used today and guess what? At this 
writing, thirty out of thirty are written wholly, or at least partly, in machine lan- 
guage! 

So, while BASIC language people are busy foisting computer literacy off onto 
the unwashed masses, and while Pascal people are stuffily trying to salvage what 
few shards that remain of the once mighty computer science theocracy, and 
while FORTH people are out acting like spoiled brats . . . while all of this is 
happening ... 

Machine-language programmers are laughing to themselves all the way to the 
bank! 
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The evidence is in and it is overwhelming. Cash on the line. If you want to 
write a classic program or a best selling program, it must be done either wholly, 
or in part, in machine language. 

Why? 

Because machine language is far and away the fastest running, the most 
compact, the most flexible, the most versatile, and the one and only language 
that most fully utilizes all of the Apple’s resources. 

The only sure way to learn machine-language programming is to do lots of 
it on your own. But one thing that can help you a lot is to tear apart the winning 
machine-language programs of others to see what makes them tick. 

You might also like to modify someone else's machine-language program to 
suit your own needs. Maybe you would like to find the scroll hooks in the HRCG 
High-Resolution Character Generator. Or perhaps you want to modify the origi- 
nal Apple Writer to output imbedded print format commands to your daisy- 
wheel. Or change F/D to add your own “undelete Ме” command. Or maybe 
you have to modify a printer driver to handle HIRES graphics dumps. Or you 
might need some stunning animation. Or want to know what makes an adven- 
ture tick. Or whatever. 

At any rate, if you brute-force attack someone else’s machine-language pro- 
gram and if the program is more than a few hundred bytes long, chances are it 
will take you a very long time to crack it to the point where you think you 
understand it. 

I'd like to share with you a method І use that will crack any unknown machine- 
language program astonishingly fast. The method does odd things odd ways, but 
ends up taking one tenth the time and one tenth the effort of any usual 
approach. 

We'll assume you already know and have done some machine-language 
programming, and that the target program you want to tear into was written by 
an experienced and more or less rational programmer who didn’t go very far 
out of his way to make things rough for you. 

Let’s see what is involved. 


THE TOOLS 


First, we'll have to put together a toolkit. You should have a tractor-feed 
printer along with some heavy white paper, preferably 20-pound paper. Natural- 
ly, you will also need a plastic 6502 Programming Card and, of course, the 6502 
Programming Manual. The following listing gives a breakdown of the tools you 
will need to effectively tear apart machine-language programs. 

You will also want all the usual App/e manuals, along with a copy of the App/e 
Monitor Peeled, and, if you can find one, а copy of the old red Apple book. I’m 
also laboring under the delusion that you'll find Don Lancaster’s Micro Cook- 
book, Volumes 1 and 2, of help. 

Try to get an Apple that has access to both an autostart ROM оп а switchable 
plug-in card, and the old monitor ROM, without autostart, in socket F8 on the 
mainframe. This original ROM has the Trace feature, which was removed to 
make way for the autostart function. More importantly, the “old” ROM gives 
you the absolute control that is needed to stop any program at any time for any 
reason. 

Note that many newer programs will not let you drop into the monitor when 
you use the autostart ROM. Instead, they adjust the pointers so that they return 
to themselves on a system reset. Thus, an old ROM may be absolutely essential 
to let you view the target code. 
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MACHINE-LANGUAGE 
TOOLKIT 


( ) 48K Apple II, preferably with 
an old ROM in mainframe 
and switchable autostart 
ROM on plug-in card. 


( ) Tractor-feed printer. 

( ) Heavy white tractor paper. 
( ) 6502 Programming Card. 

( ) 6502 Programming Manual. 
( ) А Apple manuals. 

( ) Apple red book. 


( ) Apple Monitor Peeled book. 


( ) Lancaster's Micro Cookbook, 
Volumes 1 and 2. 


( ) Roll of transparent tape. 


( ) Case of page highlighters, in 
all available colors. 


( ) Fine and regular felt-tip pens 
of matching colors. 


( ) Serendipity scratch pad. 
( ) What if? quadrille pad. 
( ) A quiet workspace. 

( ) The right attitude. 


If you really get into machine-language programming, this original firmware 
ROM is very, very useful. | suspect these ROMs may eventually become rare, 
but with 2716 EPROMs now under $5.00, you can easily clone your own by 
adding a simple CS adaptor to ROM socket F8. 

You will want at least a 48K machine, and if there is extra RAM on plug-in 
cards, so much the better. The big advantage to having more RAM than the 
program needs is that you are free to add your own test and debug programs 
co-resident with whatever target program you are tearing apart. You should have 
both a cassette and at least one disk drive. The cassette can always save any 
image of any part of any program at any time, regardless of whether there is a 
DOS operating system there or not. Images on the tape can be split up and 
relocated as needed, letting you transfer them to disk at your convenience. The 
cassette can also let you introduce very small “test” and “hook” programs into 
the darndest spaces. 

Now, off to the office supply. Get yourself a big roll of transparent mending 
tape—the kind you can write on. Then get two cases — yes, cases — of page 
highlighters. Throw away all the extra yellow ones, and get as many different 
colors as you can. Match each page highlighter with both a fine point and a 
regular felt-tip pen of the same color. 
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Don't underestimate the importance of these page highlighters. This method 
starts out real stupid like, but you will be astounded when the truth and beauty 
of what’s happening leaps out at you halfway through. The highlighters are 
absolutely essential! 

Get yourself some scratch pads as well. Label the little blank one ‘‘Serendi- 
pity” and the big quadrille one “What if?". 

You also have to have the right attitude, the right workspace, patience, persist- 
ence, curiosity, perversity, and a very distorted sense of humor for this method 
to work. 

It is extremely important that you do everything that follows hands-on and бу 
yourself. Do not, under any circumstances, let someone else or the Apple help 
you with any tedious or dogwork parts. The method relies heavily on your 
subconcious putting together the big picture and sewing up the loose ends. It 
can only do this if it has access to everything that the tearing-attack method 
needs. Do the dull stuff yourself! 


THE FIRST RULE 


What can we expect to find inside a machine-language program? The working 
code for sure. But, besides that working code, we need files that go with that 
code. In most longer machine-language programs, the files often take up far 
more room than the working code does. 


END 


STASH 
CODE 
MODULE 
| ЗТАЗН 


CODE 
MODULE 


ACTION 


START 
Fig. 3-1. A "typical" machine-language program. 


Fig. 3-1 shows your "typical" machine-language program, which is just about 
as representative as your "typical" Apple owner or your “typical” rock. Any- 
way, we see that there are usually two main areas to a larger machine-language 
program. These are the action and the фи/К files. 

The action is the "real" part of the program that actually does things. The 
action, in turn, is made up of two different types of blocks. These blocks are 
called code modules and stashes. 

A code module is a chunk of working machine-language code that does 
something. In most programs, most of the modules are subroutines, and are 
called as needed from a very short main program. The advantages of subroutines 
are that they break things down into small and understandable chunks and that 
they can be accessed from several places in the main program at once. 
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А stash is a short file that works directly with a module. The stash often follows 
immediately after the module that uses it. Typical stash entries might be a short 
ASCII string, a list of condition codes, or a table of indirect addresses. The stash 
holds values needed by the module that it works with. 

The bulk files are usually much longer than the stashes. Bulk files normally sit 
off by themselves and usually follow the action. An example of a bulk file might 
be a high-resolution character set. The action controls how and when the 
character codes in the bulk-file character set go on the screen. In a medium- 
sized adventure, the bulk files may contain the map, the script, the objects, the 
responses, the rooms, and anything else unique to one particular story line. Only 
the bulk file has to be changed to change the adventure. The action can often 
stay the same. 

In animated games or other programs that use the HIRES features, the bulk 
file may actually be the HIRES screen pages, or combinations of these pages 
with extra file space. 

If you are into very fancy machine-language programs, the action may, in fact, 
be an interpreter acting as a special-use language. The bulk files will then contain 
commands that are run under the action’s command interpretation. Zork is a 
classic example of this type of thing. In Zork, the action is a LISP-like interpreter 
specially written in compact and fast machine-language code. 

The absolute key secret to tearing into machine-language code 15... 


Find out the STRUCTURE and the 


FLOW of any program, and most 
of the code will take care of itself! 


So, never, never, never start taking apart machine-language code on a line-by- 
line basis. This is a total waste of time and will take forever. 

Not to mention that it won’t work anyhow. 

The whole trick is to find out the structure of the program. Separate each 
module of the program and then separate each file from everything else. You'll 
find out there are very powerful hidden indicators that will leap out at you when 
you look for them. These indicators will very rapidly break everything down into 
simple, obvious, easy-to-understand, and self-documenting chunks. 

Don't believe me? Let's try it and see. We'll use Apple's own HRCG High- 
Resolution Character Generator as a target program to show you how the 
method works and to illustrate key points. We'll go over the method in some 
detail. Later, we'll sum everything up in one checklist. НЕСС is available on the 
DOS 3.3 TOOLKIT diskette. 

You'll get the most out of what follows by actually doing each and every step 
using your own copy of HRCG as we go along. Then try the method on a target 
program of your own choosing. 


THE METHOD 


Ready? Here we go. 


GROK THE PROGRAM 


You must be thoroughly familiar with what the program does and how it 
works before you start. Never try to crack a code until after you have used the 
program and really and truly know it. 
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For instance, there’s absolutely no point in taking apart Pyramid of Doom to 
try and find the shovel. If you can’t find the shovel, you just aren’t cut out for 
Adventure. But, you just might want to tear into it to find the last treasure you 
need to replace the treasure you have to destroy to get past a certain —uh— 
inconvenience halfway up the pyramid. In no way will your first tearing into 
Adventure tell you the last treasure is in the dressing room, but you'll learn a lot 
about machine language and machine-language programs as you go along. 

In the case of the HRCG, use the program and thoroughly explore all the 
alternate character fonts, and all the options of each and every mode of opera- 
tion. 

Know exactly what the program does before you try to tear into it. 

One limit to this, though . . . 


NEVER assume a program works in 
a certain manner or "has" to do 


something in an obvious way! 


Thus, while you are learning how to use the program, and while you may think 
you have some good ideas on how the program works, reserve judgement till 
later. All your good ideas will invariably turn out to be 100% wrong. 

If you can, watch others use the program and look into their reactions of how 
the program works and what it does. You may be missing something totally 
obvious. Rap with others as much as possible. 


GO TO THE HORSE'S WHATEVER 


Read every scrap of documentation that comes with the program, no matter 
how badly written or misdirected it may seem. Always ask around to see if the 
source code exists somewhere. Be sure to look into updates and revisions as 
well. It is infinitely easier to start with the original author's source code and work 
into the program, than to start with an unknown bunch of code and try to infer 
what the author had in mind in the first place. 

If there is no documentation or if it isn't helpful, and if the original source code 
isn't available, keep checking. Perhaps others have torn into part of the code or 
have made modifications on their own that seem to work. Ask around at your 
club, school, computer store, bulletin board, or user group. If anything is avail- 
able that seems to help, try it. 

Anything else that can give you a clue to where the software author's head 
is and where he is coming from will be of great help. Maybe he publishes articles 
and stories. Maybe he has a series of programs out that can be of use. 

A few moments of asking in the right places can save you months of time. 

So, always check around. 


HAVE A LIMITED GOAL 


Any genuinely experienced programmer will admit to this rule . . . . 


A long program is NEVER fully BELIEVE 


debugged nor fully understood. 


Nor can it ever be. IT! 
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The entire DEW (Distant Early Warning) defense radar program was never 
tested. Not only was it never tested, the DEW program was so hopelessly 
complex that there was no possible way it could have been fully tested. Even 
if some test method existed, the probability of it passing any test was infinitely 
small. 

A good and clean program simply has most of its remaining bugs fairly well 
hidden and fairly well out of the mainstream. This only happens after the ninth 
or tenth revision. But rest assured, there are definitely still bugs there, lying in 
“deep cover” and patiently waiting. 

What this says is that the original programmer did not fully understand nor 
fully debug his program. If he says he has, he is either lying or else hopelessly 
naive. Now, if he didn't understand his own program, why should you? 

Thus, a goal “to completely understand" some program is not only unreason- 
able, it is patently ridiculous. Instead, set yourself a reasonable and realistic goal 
for your first trip of tearing into machine code. Then, after you have set this 
realistic goal, simplify it till it is trivial. Then, simplify that. Then, think up some 
really dumb test of a small part of what is left. Something any idiot could hack. 
Maybe, just maybe, you will then be in the ball park. 

For the HRCG, let's use the goal of answering "Where are the scroll hooks?” 
The HRCG obviously has some sort of scroll in it, since it moves characters up 
the screen. The scroll on the version | received is abrupt and chunky, so it can 
obviously be improved. 

Or can it? 

Maybe it's not so obvious. Why would such a good program have such an 
ugly scroll? These are name-brand people working on this and chances are they 
fumed and fretted over things quite a bit. Better stick with our original goal of 
finding the scroll hooks. 

When you set your limited goal, don't become obsessed with it. The tearing 
method works by separating the known from the unknown as you go through 
the code. The method we will use demands a lot of apparently useless side trips. 

Concentrate only on your goal and you may never get there. 


FIND WHERE THE PROGRAM SITS 


Before we can go on with our tearing attack method, we have to take time 
out for a rather long, but most essential side trip. Ready? Here we во... 

Where is the machine-language program likely to sit? A glib answer is some- 
where between $0000 and $FFFF, unless they are using memory mapping to go 
beyond 64K or unless they are swapping things back and forth to the disk. This 
assumes, of course, that the program is not self-modifying so that it changes itself 
through time. 

Figs. 3-2 through 3-6 show us some places we can put a program. We can 
divide these into /ow RAM, high RAM, and wherever. Let's check these in more 
detail. 


Low RAM 


Low RAM is heavily used. As Fig. 3-2 shows us, low RAM goes from hex 
$0000 through $07FF, or memory pages Zero through Seven. Most of this space 
is reserved by the Apple for “system” uses. Let's check this out on a page-by- 
page basis .... 

Page Zero is extremely valuable real estate for two reasons. The first is that 
the 6502 has a page Zero addressing mode that is shorter and faster than most 
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PAGES FOUR THROUGH SEVEN АВЕ 
THE TEXT AND LORES PAGE ONE. 
THERE ARE ALSO 64 RAM 
LOCATIONS IN 8 GROUPS OF 8 


EACH INTENDED FOR ПО USE. 
307ЕЕ 


(2047) PAGE THREE HOLDS THE DOS 


POINTERS AND MONITOR VECTORS 
AT ITS HIGH END. THE BOTTOM 
OF THIS PAGE IS A POPULAR 
TEXT PLACE TO PUT PROTECTED 
AND MACHINE LANGUAGE CODE. 
LORES 
(PAGE ONE) PAGE TWO IS THE KEYBOARD 
INPUT BUFFER AND WORKS FROM 
THE BOTTOM UP. SHORT 
PROGRAMS CAN BE PUT AT THE 
TOP OF THIS PAGE, BUT A 


$0400 


DANGER EXISTS OF A LONG 
ады KEYBOARD ENTRY PLOWING THE 
пов) | vere PROGRAM. 
spa. lle peace PAGE ONE IS THE STACK AND 


WORKS FROM THE TOP DOWN. 


768 

ge KEY-IN SHORT PROGRAMS CAN BE PUT AT 
BUFFER THE BOTTOM OF THIS PAGE, BUT 

$0200 A DUAL DANGER EXISTS OF THE 

(512) PROGRAM PLOWING THE STACK, 
STACK AND VICE VERSA. 

$0100 


Е PAGE ZERO HOLDS CALCULATED 
Te lt ct 
soo [_vectors_| — SYSTEM VARIABLES. THERE IS 
(0) USUALLY NO ROOM FOR ACTUAL 
PROGRAM CODE HERE, ALTHOUGH 
MOST PROGRAMS WILL USE THESE 
LOCATIONS FOR STORAGE. 


Fig. 3-2. Low RAM memory map. 


other addressing modes. The second is that the two most powerful 6502 ad- 
dressing modes — indirect indexed and indexed indirect — demand pairs of 
address locations on page Zero. 

The Apple book shows how practically all of page Zero is used up one way 
or another by the monitor, the DOS, or either BASIC. For instance, the locations 
for the keyboard entry hooks and the print output hooks are stored as addresses 
on page Zero, as are the screen formatting controls that set the height and width 
of the display. Other important page Zero locations convert line numbers into 
the base addresses needed to hit a certain line of video. 

We will see a list of these important page Zero locations shortly. The point 
here 15... 


Practically all programs need a few 
locations on page Zero. 

Some of these are used to pass 
values into the monitor, to BASIC, 


or to another part of itself. 

Other page Zero locations are 
used to hold calculated addresses 
for the indirect addressing modes. 


Thus, page Zero real estate is far too costly for program code. Instead, the 
available locations are used to pass values back and forth between the system 
and the target program, and to hold calculated address values. 

Sometimes a target program will reassign page Zero locations for its own use. 
For instance, if the target program is fully in machine language, it can borrow 
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many of the locations “reserved” for Applesoft or Integer BASIC, since these 
locations will never be used. Monitor locations that serve oddball purposes can 
also be “redefined” provided that the monitor feature is never used, even by 
accident. 

Occasionally a very short machine-language sequence can be crammed into 
low values on page Zero, as was done with the original tone subroutine in the 
old red book. Even this got you in trouble when you switched to Applesoft. So, 
putting programs on page Zero is both dangerous and dumb, but it can be done. 

Another dangerous place to put programs is on page One. Page One is 
intended to be used for the stack. The 6502 uses a single stack that starts at 
location $01FF and builds down. This stack is shared by the monitor, the 
operating system, and the program itself. Important uses of the stack are to store 
the return address of a subroutine call and both return address and processor 
status on an interrupt. Advanced programmers might also use the stack as a 
temporary stash of a value or two, or might even manipulate the stack to alter 
the program flow. 

The stack rarely gets below $0180 in normal use. It is usually possible to put 
a very short machine-language program in locations $0100 through $017F. This 
is dangerous, since the program can plow the stack and vice versa, if either gets 
too long. 

Page Two is normally used as a keyboard buffer. Key entries start at $0200 
and build their way up. The average number of keystrokes stored is fairly low, 
and you can sometimes cram a small machine-language program on the top of 
this page. Once again, you are asking for trouble since too long a keyboard entry 
will plow your program. 

One sneaky and ugly trick that a programmer can pull is to put some reloca- 
tion or protection code starting at $0200. This code must be used before any 
keys are hit, and is thus very difficult to read. The code will, of course, get 
destroyed as soon as any keys are entered. 

Most of page Three is available to the machine-language programmer. There 
are some DOS jumps and system vectors on the high end of this page. The 
vectors control the reset, interrupt, autostart return, breakpoints, Applesoft ''&'', 
and nonmaskable interrupt jumps. 

Thus, you are free to use the first 150 or so locations on page Three for your 
machine-language program. This turns out to be a favorite stash for short pro- 
grams, since this area is automatically protected from either BASIC. 

Unfortunately, everybody and his brother crams just about everything they 
can think of in here, and you can often have two parts of a program, each of 
which needs a different machine-language code, both trying to use this space. 
For instance, a printer driver may be placed here by one program and a screen 
dump by another. Try to combine the programs, and you have a turf fight. 

If you have a longer machine-language sequence, you can sometimes com- 
bine the top half of page Two continuously with the bottom half of page Three. 
Again, you have to be careful not to get bumped by a long keyboard entry and 
to be sure you don't, in turn, bump into a DOS hook or other pointer. 

Memory pages Four through Seven are the page One text screen and page 
One LORES screen. The only difference between traditional text and LORES is 
that, in text, the stored code goes through a hardware character generator while, 
in LORES, the same code is directly bit-by-bit converted into a stacked pair of 
colored blocks. 

It seems kinda dumb to try and put machine-language code onto the display 
pages. First, you will probably see it and it will look ugly. Secondly, any scrolling 
or screen clearing will destroy the code. Nonetheless, in a program that does 
all its work in HIRES, this space is theoretically available. 
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There are some sneaky RAM locations stashed here and there on pages Four 
through Seven that are not displayed and are not erased by a properly done 
scroll or clear. There are 64 of these locations. These are normally intended for 
use by the 1/О slots and have intended assignments. 

If you really want to be tricky, you can use these spaces any way you want 
to, provided there is no |/О access to the same location. This is one of the best 
hiding places for disk verification codes and other sneaky stuff. 

Summing our low RAM up, you have a few locations on page Zero available 
to you that are usable to pass values to the monitor or to save calculated 
addresses. The low end of the page One stack and the high end of the page Two 
keyboard buffer can be used for short programs or subroutines, but use of these 
areas can be dangerous. Most of the bottom of page Three can be used for a 
machine-language program. This space is very popular but it can cause conflicts 
between programs. Finally, pages Four through Seven are the page One text and 
LORES display and are not normally available for program storage, except for 
some 64 hidden locations that are normally reserved for input and output. 


High RAM 


As Fig. 3-3 shows us, the high RAM runs from $0800 up through the top of 
installed RAM. In a 48K machine, high RAM goes from $0800 through $BFFF. 
This area holds the usual locations where longer machine-language programs are 
placed. 

How much of high RAM is available for your use? It all depends on what other 
features you are going to run along with your program, and what minimum size 
Apple you want the program to run on. 

We will assume that the target program needs a full 48K. Extra RAM is now 
so cheap that practically all Apples either arrive with full RAM or are soon filled. 
With those new 64K RAM cards, most Apples will soon have bunches of extra 
memory on top of what used to be "full." A machine with a mere 48K of RAM 
will soon be at poverty level. 

At any rate, if you decide to use text page Two or LORES page Two, locations 
$0800 through $0BFF have to be set aside and protected. Use of this text page 
is relatively rare. 

If you want to use HIRES page One for graphics, sprite animation, or multifont 
text displays, then locations $2000 through $3FFF have to be reserved. Use 
HIRES page Two and you will also have to reserve locations $4000 through 
$5FFF. These locations hold an image of what goes on the screen and, thus, are 
not available for both display and program use at the same time. You will 
sometimes use both pages at once for effective and fast animation or to double 
graphics resolution. 

While there are a few unused RAM locations on these HIRES pages, these 
locations get plowed every screen reset or color change. Thus, they are not 
safely usable except as a very temporary stash. 

We will note in passing that if the HIRES pages are not used, and you put code 
in this area, you can actually watch the code executing by switching to HIRES 
while the program is in action. This can be a very powerful snooping tool. 
Watching a program run its own code gives you a new window into what is 
happening. You can also watch code working on LORES page Two, but this is 
a much smaller area and not nearly as useful. 

If you are using standard DOS, the space from $9600 through $BFFF is 
normally saved for the DOS system. You can sometimes "borrow" a DOS file 
or two and stuff a short machine-language sequence into a small portion of this 
protected space. 
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$BFFF 
(49151) 


$9600 
(38400) FILE AREAS. THIS SPACE MAY 
BE FREED UP BY GOING TOA 

SMALLER CUSTOM DOS OR BY 


MOVING DOS ONTO A RAM CARD. 


THE DOS 3.3 OPERATING SYSTEM 

SITS AT THE TOP OF HIGH RAM. 

SMALL WORKING PROGRAMS CAN 
: BE STORED HERE IN UNUSED DOS 


йн PROGRAM SPACE. 


HIRES PAGE TWO IS USED FOR 
ANIMATION AND GAMES WHERE 
ONE PAGE IS DISPLAYED WHILE 
THE OTHER 15 MODIFIED. MUST ВЕ 
PROTECTED WHEN USED. 


$6000 | 
(24576) 


HIRES 
(PAGE TWO) 


$4000 

(16384) HIRES PAGE ONE RESIDES HERE 
AND IS USED FOR BOTH COLOR 

————— GRAPHICS AND MULTIFONT TEXT 
DISPLAYS. MUST BE PROTECTED 


WHEN USED. 


HIRES 
(PAGE ONE) 


$2000 


(8192) | 
ae AVAILABLE PROGRAM SPACE. 


50С00 

(3072) LORES AND TEXT PAGE TWO. 
$0800 VERY RARELY USED. 

(2048) 


Fig. 3-3. High RAM memory map. 


A lot of programs provide their own smaller and simplified versions of DOS. 
This gives a measure of copy protection and makes more room for the rest of 
the program. 

Thus, a machine-language program could go from $0800 to $BFFF. Subtract 
the range $9600 through $BFFF for DOS at the top, the range $4000-$5FFF for 
HIRES page Two, the range $2000-$3FFF for HIRES page One, and, if used, the 
range $0800 through ФОВЕЕ at the bottom for text and LORES page Two. 

Many machine-language programs start at $0800 and work their way up- 
wards as needed. If they are about to crash into the HIRES pages, they jump 
above HIRES and continue as far as they have to. 


Combining programs 


Things get much more complicated if machine-language subroutines have to 
interact with Integer or Applesoft BASIC programs. Each BASIC language works 
differently and needs a different way to "protect" an area for its machine- 
language routines. The protection is needed to keep the BASIC from overwriting 
the machine code and vice versa. Fig. 3-4 shows us more detail. 

In Integer BASIC, HIMEM is a high-memory pointer that points to the end of 
the Integer program. The program starts at HIMEM and builds its way down- 
ward. Every new program line gets put in its place, automatically moving every- 
thing else down and leaving you with the end of the program listing at HIMEM. 
String variables start at the low-memory pointer LOMEM and build their way 
upwards. 

The usual way to tie a machine-language program into Integer BASIC is to start 
the machine-language sequence at $0800 and set LOMEM to at least one space 
above the end of the machine-language code. This LOMEM can be set as the 
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first instruction of an Integer BASIC program. It takes an “illegal” command, but 
it is easily done with a single POKE command. Should you also be using the 
HIRES pages, you still would start your machine-language program at $0800, but 


NORMAL 
HIMEM 
INTEGER 
BASIC 
PROGRAM 
LOMEM SET 
2 _— _TO TOP OF 
MACHINE 
CODE +1 


$0800 


(А) Integer BASIC, no HIRES. 


$9600 


HIMEM SET 
А —— ТО BOTTOM 
OF MACHINE 
CODE -1 
APPLESOFT 
STRINGS AND 
VARIABLES 
? F------- —— LOMEM 
APPLESOFT 
PROGRAM 
LINES 
START OF 
PROGRAM 
$0800 =| ~— POINTER 
SET TO 2048 
(TXTAB) 


(C) Applesoft BASIC, no HIRES. 


NORMAL 
HIMEM 
INTEGER 
BASIC 
PROGRAM 
—_ LOMEM SET 
TO 16385 


HIMEM SET 
TO BOTTOM 
? *— OF MACHINE 
CODE -1 
APPLESOFT 
STRINGS AND 
VARIABLES 
LOMEM SET 
$4000 TO 16385 
HIRES 
PAGE 1 
$2000 | 
? | APPLESOFT 
PROGRAM START OF 
LINES PROGRAM 
$0800 — —— POINTER 
; SET TO 2048 
(TXTAB) 


(D) Applesoft BASIC using HIRES 1. 


Fig. 3-4. Usual ways of combining BASIC and machine-language programs. Note that 
machine code goes above Applesoft or be/ow Integer. 
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you would most likely reset your LOMEM pointer to one location above the 
highest HIRES screen location needed. This is shown in Fig. 3-4B. 

Applesoft does things quite differently than Integer Basic. Applesoft programs 
start at a start-of-program pointer TXTAB and build their way up, while the string 
variables start at HIMEM and work down. 

It is not normally possible to change the start-of-program pointer during a 
program since the program is already located in memory and is not movable. 
Thus, while you can, in theory, put a machine-language program below this 
pointer, the only way to do it is to change the start-of-program pointer before 
you load your final Applesoft program. 

Note that this start-of-program pointer is not LOMEM! It is called TXTAB and 
sits at $0067 (low) and $0068 (high). LOMEM in Applesoft is actually in the 
middle. LOMEM points to the beginning of the variable space and often marks 
the end of the program lines. 

You will usually put your machine-language program above Applesoft by 
setting HIMEM before you run your Applesoft program. HIMEM may also be 
set early in the program. Details on this are shown in Fig. 3-4C. 

For more program room, you also have the option of setting HIMEM to one 
less than the start of your machine-language program, and LOMEM to one more 
than the highest HIRES location in use. The start-of-program pointer remains at 
$0800. This lets you put program lines from $0800 up through the start of the 
HIRES page, and place the strings and variables from the top of the HIRES space 
to the bottom of your machine-language code. This is shown in Fig. 3-4D. 

So, we see that machine-language programs running with Applesoft normally 
go above НІМЕМ, while machine-language programs running with Integer 
BASIC normally go below LOMEM. 

„Мои can also play all sorts of pointer games to tow a short machine-language 
sequence along /nsidean Integer BASIC or Applesoft program. One way you can 
do this is to put the machine-language stuff between two BASIC statements. The 
parsed code on the first BASIC statement is then altered so it jumps over the 
machine-language part to get to the next expected instruction. These pointer 
schemes are tricky and really get hairy if you make any changes, but some 
authors use them to “protect” their programs or “hide” their fast machine code. 
The advantage of this is that you can use one cassette loading to enter both 
machine and BASIC codings. With a disk it is much simpler and saner to let one 
program load the other one by using a second disk command. 

Mainframe RAM usually only goes up to 48K. What is in the other 16K of our 
64K Apple? Figs. 3-5 and 3-6 complete the picture for us. 

There are sixteen pages located from $С000 through $CFFF that are reserved 
for I/O. As Fig. 3-5 shows, the bottom half page ($С000 to $CO7F) is used for 
all the screen switches, the push buttons, the paddles, speaker, cassette, key- 
board entry, and the keyboard strobe. The next half page ($C080-COFF) is used 
to pass address locations to each slot. There are sixteen locations reserved for 
each slot one through seven. 

Above that, we see seven location blocks that are one page of 256 words 
each. These usually will hold the "control" PROM or ROM for a given card and 
are addressed as shown. A final 2K space is reserved from $C800 through $CFFF 
that can be used by any 1/О slot that wants it, as long as all the slots take turns, 
and only one slot is active at a time. 

There is usually very little RAM in the 1/О space. These locations are impor- 
tant, though, for they are how we control the on-board things like the screen 
modes, speaker, paddles, keyboard, and so on. They are also the way we 
interact with any working card. If a plug-in card is involved with the code you 
want to tear into, you will have to pin down exactly what codes goes where. 


42 Enhancement 3 


If we now turn to the uppermost 12K of address space on the Apple, we see 
that there are six ROM sockets on the Apple mainframe. Each socket can hold 
a 2KX8 bytewide ROM or RAM. Fig. 3-6 shows us the usual setup for Integer 
BASIC or Applesoft machines. A 2K monitor ROM needs the top or $F8 socket. 
There are two possible monitors, the old or abso/ute reset one, and the newer 
autostart one. 


ЕЕЕ 53247 


(- 12289) 
2k ROM 
OR RAM 
USABLE BY 
ANY SLOT, 
PROVIDED 
THEY TAKE 
TURNS 
Fig. 3-5. МО map. 
51200 
5800 (- 14366) 
50944 
50700 (- 14592) 
50688 
$0600 (мез) 
50432 
50500 (- 15104) 
50176 
$C400 [= 45356; 
49920 
$6300 (- 15616) 
49664 
30200 (= 15872) 
9408 
$C100 (- 16128) 
4 
5С080 (16258) 
50000 49152 
(- 16384) 


Continuing down our ROM sockets, Applesoft uses the bottom five, while 
Integer BASIC uses the middle three, along with an optional programmer's aide 
that fits in the bottommost or “DO” socket. The uppermost Integer ROM at “ЕО” 
also holds the extremely useful single step and mini-assembler code, along with 
the old floating-point package. Nane of these machine-language test and debug 
features are available in the Autostart ROM. 

This area is all ROM and cannot normally be written to. But the locations in 
this area are useful to interact with the monitor or either BASIC language. 

The entire top of the machine can be bypassed by any plug-in card through 
the INH line. This can let a plug-in ROM card give you the switched choice of 
either BASIC, or it can let a RAM card do darn near anything it wants to, 
including running other languages or giving you extra RAM space. 
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SFFFF та SFFFF ms 
$7800 L SSEMBLER | (- 2048) in (— 2048) 
SF400 62464 
(- 3072) 
INTEGER 
BASIC 
INTERPRETER APPLESOFT 
BASIC 
57344 INTERPRETER 
$6000 (- 8192) 
| 55296 
$0800 42 
PROGRAN- | (- 10240) 
$0000 (— 12288) 50000 (-12288) 
(А) Integer BASIC. (B) Applesoft. 


Fig. 3-6. High ROM maps. A plug-in ROM or RAM card can deactivate these and 
substitute its own code. 


Note that many software programs placed on RAM cards may deny you ever 
gaining access to the monitor ROM in mainframe socket $F8. This can make 
intercepting a running program rather tricky. 

Many machine-language programs will start at $0800 and work their way 
upwards, but you can expect any program to go just about anywhere, depending 
on what other resources of the Apple are being tapped. 

One ultrasneaky trick is to start your machine code at the bottom of the 
keyboard buffer at $0200, with a jump, and then run up through everything in 
between there and the end of your machine-language program. This neatly hides 
the “тегі” starting address of your program and also gives you an attractive page 
One text or LORES display while the rest of the program is loading. 

You must, of course, find out where the program is before you can attack it. 
Let's start with a very obvious fact... . 


You cannot tear a program apart 


that is not already in the machine 
OBVIOUSLY and capable of running. 


What this says is that any program that uses a disk may not have that part of 
the program in which you are interested sitting in the machine at any given time. 
This rule also says that any program must be placed in the machine exactly 
where it normally will run, and it must be started off on exactly the first instruc- 
tion location. 

So, be sure you have that part of the program that you want to analyze in the 
machine when you attack it. 

The other side of the сот has the good news . . . 


At any given time, any working 
BUT, program MUST have everything it 
TH EN needs in the machine so it can 


continue. 


AGAIN 


So, if there is no disk whirring between where you are and what you want 
to analyze, it all has to be there in the Apple somewhere, somehow. 
But, where is where? 
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You must ріп down all of the exact locations а target program uses before you 
can tear into it. There are at least four good ways to do this . . . . 


FINDING PROGRAM 
LOCATIONS 


( ) Read the instructions. 


( ) Ask DOS to tell you. 
( ) Infer from use. 
( ) Empty, then fill the machine. 


The first and most obvious way is to see if the author didn't tell you some- 
where just exactly where the program sits. For instance, the loading instructions 
for the Adam's Adventures 0-12 tell you these go from $0800 through $57FF 
and that the starting point is $0800. Being told ahead of time where the program 
starts and resides is the easiest and best method, so always look around carefully 
for loading information. 

The second way to find where a machine-language program goes is to let DOS 
tell you. On a 48K machine BLOADed under DOS 3.3, the starting address ends 
up stashed in $AA72 (low) and $AA73 (high). The program length is stashed in 
$AA60 (low) and $AA61 (high). After loading, you reset, do a call — 151 to get 
into the monitor, and, then, inspect these locations. The old monitor ROM might 
be needed to force reset back into the monitor. 

DOS can also give you some hints. If you can read the catalog, the type of 
file and its length should be obvious. Even listening to the number of track clicks 
during a load should tell you something about how long the program is and 
which disk tracks it lies on. Take off the disk drive cover, and you can actually 
watch the drive move from track to track. With some practice, you will be 
surprised how much this can tell you. 

The third method of finding a machine-language target program's lair is to infer 
where the program sits from what it has to do and what it has to interact with. 
Our НКСС gives us a good example here. We can't directly find where HRCG 
sits since it is an “R”, or relocatable, rather than a “В”, or binary file. 

But, the Applesoft Toolkit book tells us HRCG fits under DOS and moves 
HIMEM down to protect itself and its alternate character fonts from Applesoft 
incursion. There's a simple and easy-to-use BASIC program called LOADHRCG 
that comes with the HRCG program. In it is a variable called ADRS which equals 
HIMEM. Run this one with no alternate character sets, and we see that ADRS 
ends up as $8DFE. Run it with one alternate character set, and HIMEM moves 
three pages lower to $8AFE. Two alternate sets and HIMEM drops three more 
pages lower to $87FE, and so on. This special example is shown in Fig. 3-7. 

So, by inference, НЕСС sits from $8DFF through $95FF. This will include the 
НКСС action and the bulk file used for character set Zero, the default ASCII set. 
Other character sets build downward three pages at a time, with the lowest- 
numbered set on the bottom and the highest set always at the top, again as 
shown in Fig. 3-7. 

You can find this out on your own by carefully studying a printout of the 
LOADHRCG Applesoft program and then doing loadings and finding the value 
of ADDR, otherwise known as HIMEM. The same study should show you how 
the alternate character sets are filled in. 
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The final method of pinning down a large program works even if all other 
methods fail, and should be used as a check even if you are absolutely sure 
where the target program sits. This final method is a sledgehammer. You empty 
the machine completely, and then refill it only with your target program. Then, 
you casually flip through memory, a page at a time, till you find the program. 
The next tearing step gives us full details on this. 


$9600 Ё CHARACTER SETS BUILD DOWN 
FROM HRCG. THE HIGHEST SET 
ALWAYS GOES JUST BELOW HRCG. 
HIMEM MOVES DOWN AS FAR AS 
$8DFF NEEDED TO MAKE ROOM FOR 
aii MORE SETS. 
$87FF 
$84FF APPLESOFT HIMEM 
4 POINTER $84FE 
(FOR 3 ALT SETS) 


Fig. 3-7. Location of HRCG program and alternate character sets in a 48K Apple Il. 


We have now seen how an Apple's memory is arranged and the methods we 
need to use to find where a program sits. Let's now return to the mainstream 
of our tearing attack. 

You can use any method you like to pinpoint exactly where the target program 
lies. Try reading instructions, and then try letting DOS tell you. Then, try infer- 
ence from what the program does and how it interacts with the Apple. If none 
of that works . . .. 


EMPTY THE MACHINE 


There is nothing more infuriating than to find out you are really analyzing 
interpreted BASIC code left over from last Tuesday's 4 AM breakout game, 
instead of your target program. 

To prevent this from happening, you will want to completely and absolutely 
empty your machine of everything old and unneeded before you begin. There 
are two very good reasons for this. One is that you won't be wasting your time 
analyzing something that is not part of your target program. The second is that 
an empty machine that has just been filled is one sure way to find or verify the 
location of your target program. 

You should always clear your Apple of old stuff before attacking a target 
program. But, how do you empty a machine? 

Even a just repowered Apple will come up with random garbage in most all 
of the RAM locations. The trick is to load each and every memory location with 
an obvious value that is very easy to spot, particularly when it is scrolling by. 
The value $00 is dangerous since it is also a Break command, and it is hard to 
read on the fly. | use the value $11 instead. On a listing, you get an unmistakable 
string of continuous lines on anything that is still empty. This pattern is readable 
even during an abrupt scroll. 

The following steps show us how to empty your Apple. It's very easy to do 
from the monitor. You put a $11 somewhere and, then, move it as far up in 
memory as you want, recopying it over and over again. If you are using DOS 
3.3, you should empty locations $0220 through $03CE, and $0800 through 
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$95FE. Ве sure to empty your machine after booting DOS. Do things the other 
way around and the DOS-booted code will return to haunt you. 

If you are not using DOS, then you can go ahead and empty $9600 through 
$BFFF as well. You might also like to empty page One from $0100 to $0180. 
But, don’t try to empty page Zero, the top half of page One, the first few 
locations of page Two, the top of page Three, or anything above $С000. Erasing 
any of these locations will bomb the machine or cause other problems. 

To empty your Apple, put an “empty” symbol in some location. Then, use 
the monitor to move a block of memory—starting at that location and moving 
up by one. 

A good empty symbol is “$11”. 

A. To empty user RAM except for DOS: 


*0800: 11 <cr> 
*0801 < 0800.95FEM «cr» 


B. To empty all user RAM: 


%0800: 11 «cr» 
*0801 <0800.BFFEM <cr> 


C. To empty most of pages $02 and $03: 


*0220: 11 <cr> 
*0221 <0220.03CEM <cr> 


To get into the monitor from either BASIC language, do a CALL —151. Do 
not try to empty page Zero, the top half of page One, the first few locations on 
page Two, page Three above $03CF, or anything above $С000. 

Some target programs will try to prevent you from ever going into the monitor. 
Switch to the old (nonautostart) monitor ROM if this happens. 

When your machine is empty, snoop around everywhere to see what it looks 
like. From the monitor, do a 0800.BFFF «cr» and watch the "elevens" go 
streaming by. 

You'll next want to load and verify the locations of the HRCG program from 
$8DFF through $95FF. Try adding alternate character sets, one at a time, and 
see what happens. 

Always start with an empty machine and always return to one anytime you 
get confused as to what is happening. 


LIST THE PROGRAM 


After you have emptied the machine and loaded your target program, go 
ahead and list it. Make two copies on the heaviest white tractor paper you can 
find. You list a program from the monitor by typing the starting address and, 
then, the character “L” eighty times and, then, a «cr» . Each L command gets 
you twenty lines of disassembled code. Use too few L's and you will have to 
retype them in the middle of your listing. Too many and you simply hit RESET 
when you get to the end of the target program. 
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Keep three clean white pages before and after the listing. Do NOT take the 
listing sheets apart. Instead, carefully reinforce every tear line, tractor holes and 
all, with transparent tape. Actually, you would be best off having a welder 
transcribe a copy of the listing by burning it into quarter-inch steel plate for you. 

No matter how rugged you make it, it won’t be enough. The object here is 
to keep the listing іп one piece and legible after handling and rehandling over 
and over again. So, don’t spare the tape. 

Label the top sheet with the name of the target program and the date you 
started attacking it. Don’t forget the year and version number. The second copy 
is a backup to be used when the first one falls apart or gets totally illegible. 

You will also want to make two copies of a hex dump of the target program. 
For HRCG, you get in the monitor, type 8DFF.95FF, reach over and move the 
printer paper up a space or two, and, then, hit <cr>. Incidentally, on both the 
listings and the hex dump, use the printer's skip-over-margin feature if you have 
it available. 

Most of our tearing apart will be done on the listing sheets. The hex dump 
sheets will sometimes show us a pattern in a file or will give us some other 
pictorial information or other visual clues that can be of enormous help. 

Yes, you might have to list and hex dump the entire machine for really fancy 
programs, and this will take bunches of paper and, maybe, a ribbon or two. But 
this isn’t nearly as bad as it seems, and it must be done if you are to crack the 
program. 

Well, we finally have completed our preliminaries. It sure took a long time to 
get here. Now the fun starts. Ready? 


SEPARATE THE ACTION FROM BULK FILES 


Carefully look at your listing. Not for detail, but for overall vibes. Anytime you 
think something may be helpful, jot it down on one or another of the pads. 

But, once again, do not jump to conclusions and do not attempt to analyze 
any part of the code in detail. At this stage in the game, we are interested only 
in the flow and pattern of the big picture. 

The first thing we want to do is isolate the action so that we can work with 
it separately. As you go along, you will gain a feel for what | call "rational" code. 
Rational code has a flow to it, with reasonable commands used in reasonable 
ways. At this point, we don't want to pass judgement nor force conclusions as 
to what is which. But see if you can't separate obviously "rational" code from 
everything else. 

Now, we told our lister to list—assuming that it would be handling working 
machine-language code. The lister will also try to list a file, or random garbage, 
as if it was rational code. So, we can expect lots of visual clues as to whether 
we are working on real code or file values. Here are some sure signs of a file. 


FILE CLUES DURING A LIST 


( ) Lots of question marks. 

( ) Break commands ($00). 

( ) Dumb repetition. 

( ) Rare commands in odd mixes. 
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Тһе question mark means that the lister thought it had found an illegal op 
code, something that the 6502 microprocessor does not know how to use as 
an instruction. Now, there are times and places where you will get an occasional 
question mark in the middle of working and valid code. This has to do with the 
“lister” getting out of whack on the first instruction, or it may (rarely) be a value 
or two a programmer has put between working code segments. But, lots of 
question marks are a good sign of a file. 

The break or $00 command is a very enigmatic one. BRK is a very heavy 
debugging tool and one of the most powerful commands that the 6502 micro- 
processor has available. But, a break command is only rarely allowed to appear 
in working code as a valid instruction! Why? Because the break command 
immediately forces a debugging interrupt, or else, it might very rarely be used 
for an error trap or a program restart. 

Dumb repetition is another clue. Say you push the processor status on the 
stack with a PHP command. That’s fine. But, why on earth do it fifteen times 
in a row? Now, that is irrational. As you go along, you will get a feel for what 
is rational code and what is not. 

Do it. Start through your HRCG listing. There’s a few question marks at the 
beginning and a few breaks, but mostly it is rational code. Chances are these are 
stashes that go with the code modules. As you go along, you get lots of rational 
code. Continue some more. Page after page of rational code. 

Then, suddenly, around $92DF, things get weird and stay that way, all the way 
to the end of the program. Lots of question marks, breaks, and really dumb code. 
Let's take a guess and say that our bulk file goes from $92FF to $95FF. 

Now, it looks like there's some garbage, maybe a stash below $92FF, but we 
definitely have at least three pages of bulk file at the top. 

Let's speculate. Three pages should ring a bell. Check into the HRCG book 
and you'll find it takes three pages for an alternate character set. Apparently, we 
have the default ASCII character set here. We absolutely should NOT jump to 
conclusions this early in the game, nor should we try a detailed analysis of the 
bulk files, but maybe just a little peek won't hurt... . 

Check the hex dump for these pages. See the pattern? Hold it up to the light. 
Every eighth row almost, but not always, is all zeros. Except for the lower case 
в, p, and a few other exceptions, most characters would leave one dot row out 
of eight blank. 

Strong evidence. 

But, not strong enough. Later, we will tear into this bulk file and verify exactly 
what it does. We will also find out exactly where it starts. For now, let's draw 
a bright red line across the listing page between $92FD and $92FF. Label the 
area below this line “BULK FILE." On your serendipity pad, sketch something 
like Fig. 3-8, that is used to show us with an HRCG action from $8DFF through 
$92FE and a bulk file from $92FF through $95FF. 


$95FF ` 
BULK HOLOS DOT PATTERNS 
FILE —— FOR DEFAULT 
CHARACTER SET 
592ҒҒ 


HOLDS CODE MODULES 
~+— AND STASHES USED 
BY HRCG 


S8DFF 
Fig. 3-8. Separating the action from the bulk files. 
Don't worry, just yet, about the extra question marks we have above the bulk 


file. Somehow, these look “different” from the code in the bulk file. As you gain 
practice, these slight differences will leap out at you. But, our goal, here and 
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now, is only to separate the action from the bulk files, nothing more. In HRCG, 
this roughly cuts our task in half. In other programs, the bulk files may be the 
lion’s share of the code. 


PAINT ALL SUBROUTINE RETURNS GREEN 


No matter what code you write or how secretive you are, there is an Achille’s 
heel you have to contend with. This is the 60 RTS or Return From Subroutine 
command. RTS is our first and foremost attack point into unknown code. It is 
the chink in the armor, the pry point, the skeleton key. Let's split off the subrou- 
tines and watch how fast the code breaks up. 

Go through your code and at every “rational” place that you find a 60 RTS, use 
a highliter to put a green bar through the code. Something like this . . . 


GREEN STRIPE = 


Do this for every 60 RTS you see in the action. If you aren't sure whether the 
60 is rational or not, then color on/y the RTS green, rather than the entire line. 
Generally, question marks below a 60 RTS are allowed; those close above are 
suspect. 

If you do this on HRCG, you should end up with 35 "'definites" that are 
greenlined all the way across, and one “maybe” located at $8F85 that is only 
boxed. 

Do not try to analyze any of this code yet. We will let the code analyze itself 
later on. 

We have just identified the end of every subroutine in the program. Since 
properly written machine-language programs will be mostly subroutines, we 
already have nearly all our code modules isolated! All that with several strokes of 
a fuzzy green page highliter! 

Now, things start to get interesting... . 


PAINT ALL SUBROUTINE CALLS ORANGE 


Next, get yourself an orange page highliter and go through the action. Identify 
every rational JSR and its address in orange. 

Do this two ways. If the JSR goes to a /oca/ address inside the action, paint 
only the JSR and the address. If the JSR goes out-of-range to some other part of 
the memory, paint the JSR, the address, and one inch more, and “half” ап 
arrowhead. 
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Like so for a local JSR... 


зввов- 20 ir ВЕ SM 


ы ОНАМСЕ 


This subroutine call is in range, so we color only Ше JSR and Ше $8E1F. 
For an out-of-range or “long distance" call, do it like this . . . 


ORANGE те 


бк od un тр — 


You use the arrowhead to identify an out-of-range call. Should you have a 
questionable ог possibly irrational subroutine call, color only the JSR mnemonic 
for now. (The reason for only half an arrow is that you might get two arrows 
side-by-side. If this happens, make one point “ир” and the other ^"down.") 

Orange is a nice color, so let's use it some more. For each and every local 
JSR call, find out where the JSR goes to, and color the very start of that line 
orange. Go only through the address, starting a quarter of an inch to the left. 

For instance, at $8EOE, you have a local call of JSR $8E1F. Go to the start of 
line 8ETF and do this . . . 


LDA %574 


This tells us that we are starting on some “live” and rational code, and that 
what follows will be a useful and worthwhile subroutine. Once again, we do not 
want to analyze any code just yet. 
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Two fine points. If there is a/ready an orange stripe here, or one of another 
color, just put a small black dot on the existing stripe. Each new time this 
happens, add a new black dot. 

This will give you a “popularity poll" of your subroutines. We probably won't 
use this voting result for our HRCG analysis, but in a large program, the populari- 
ty of a subroutine can tell you how important that sub is and how much effort 
you should spend in understanding it. 

А second possibility is that your JSR seems to go to the middle of an op code, 
instead of just the start. The most likely reason for this is that the lister got off 
on the wrong foot. See the "WILL THE REAL LISTING PLEASE JUMP OUT" 
sidebar located at the end of this enhancement for details on this. What happens 
is that the lister starts off with a value or two in a file and assumes it is a valid 
part of a program that can be disassembled. Op codes normally take one, two, 
or three bytes. If the first byte is wrong, the listing will also be wrong. 

If you get a “JSR to the middle of . . .”, try relisting from the JSR address to 
see if you get rational code. This will help clarify the boundaries between stashes 
and code modules. We will see an example of this later. 

Should your JSR want to go to your bulk file, you guessed wrong! Either the 
bulk file has a code module in it, or else your JSR really is a random “20” in 
a stash somewhere. Pay careful attention to loose ends like this, for pinning 
down exact code and file beginning addresses can save you hours of frustration. 

After all of your local subroutines are taken care of, try to identify the out-of- 
range ones. They must go somewhere. Somewhere is most often a monitor sub- 
routine, or some DOS subroutine or subs in either BASIC. 

Table 3-1 shows us the most popular locations needed by the monitor, DOS, 
and I/O. Try to get a match between Table 3-1 and each out-of-range subroutine 
call. Label this match with a brown felt-tip pen. We have purposely kept this list 
down to the more popular locations. We may look at Applesoft, Integer BASIC, 
and DOS internals in a future enhancement. Most user libraries have very 
extensive memory listings if you get into something out of the ordinary. 

For instance, in $8E16, we have a JSR $FDED. A check of Table 3-1 shows 
us that it is one of the most often used monitor routines called COUT. This 
routine takes what is in the accumulator and outputs it as a character. This output 
goes to whatever is connected to the character output hooks. The code should 
now look like this . . . 


58Е16- 20 ED FD amd COUT (output character) 


BROWN FELT ТІР = 


Notice that this immediately tells us that the code module is used to output 
characters. This very much pins down how the module is used and its place in 
the big picture. And we still haven't analyzed any code. 

Sometimes a JSR call will point to a different part of user RAM. This usually 
means that the target program is in more than one piece. Each piece, of course, 
will eventually have to be dealt with. The Wizard and the Princess is a good 
example of a program that has code modules all over the lot. 
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Table 3-1. Important Monitor, DOS, and ИО Locations 


PAGE $00 
Mnemonic 


WNDLFT Leftside of scroll window 
WNDWTH _ Widthofscroll window 
WNDTOP — Topofscroll window 
WNDBTM Bottom of scroll window 


CH Cursor horizontal position 
CV Cursor vertical position 
GBASL LORES graphics base low 
GBASH LORES graphics base high 


BASL TEXT base address low 
BASH TEXT base address high 
BAS2L Scroll temporary base low 
BAS2H Scroll temporary base high 


COLOR Holds the LORES color value 
ІМУҒІС Normal/Inverse/Flash mask 
PROMPT Holds prompt symbol 

YSAV Temporary Y register hold 


CSWL Output character hook low 
CSWH Output character hook high 
KSWL input character hook low 
KSWH Input character hook high 


ACC Accumulator save 
XREG Xregister save 
YREG Y register save 
STATUS Flag register save 


SPNT Stack pointer save 
RNDL Keybounce random number low 
RNDH Keybounce random number high 


PAGE $03 
Mnemonic 


Re-enter DOS 

Reconnect DOS МО hooks 
BRKV Break vector low address 

Break vector high address 


SOFTEV Warm start vector low address 
Warm start vector high address 

PWRDUP Warm start EOR A5 checksum 

AMPERV Applesoft “&” Jump Code 


USRADR Control Y Jump Code 

NMI NMI vector jump Code 

IRQLOC interrupt vector low address 
Interrupt vector high address 
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Table 3-1 Cont. Important Monitor, DOS, and I/O Locations 


PAGE $CO 
Mnemonic 


— 16384 IOADR Keyboard input location 
—16368 KBDSTRB Keyboard strobe reset 
—16352 TAPEOUT Cassette data output 

- 16336 SPKR Speaker click output 


—16320 STROBE Game МО connector strobe 
— 16304 TXTCLR Graphics ON soft switch 

— 16303 ТХТ5ЕТ Text ON soft switch 

= 16302 MIXCLR Full screen ON soft switch 


— 16301 MIXSET Split screen ON soft switch 

— 16300 LOWSCR Page ONE display soft switch 
— 16299 HISCR Page TWO display soft switch 
— 16298 LORES LORES ON soft switch 


~ 16297 HIRES HIRES ON soft switch 

— 16296 Annunciator 0 OFF soft switch 
— 16295 Annunciator 0 ON soft switch 

— 16294 Annunciator 1 OFF soft switch 


— 16293 Annunciator 1 ON soft switch 
— 16292 Annunciator 2 OFF soft switch 
— 16291 Annunciator 2 ON soft switch 


— 16290 Annunciator 3 OFF soft switch 
— 16289 Annunciator 3 ON soft switch 
— 16288 TAPEIN Cassette tape read input 

— 16287 PBO Push button 0 input 


= 16286 PB1 Push button 1 input 
—16285 PB2 Push button 2 input 
—16284 PDLO Game Paddle 0 analog input 
— 16283 PDL1 Game Paddle 1 analog input 


— 16282 PDL2 Game Paddle 2 analog input 
— 16281 PDL3 Game Paddle 3 analog input 
— 16272 PTRIG Reset analog paddle inputs 
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Table 3-1 Cont. 


Decimal 


Important Monitor, DOS, and I/O Locations 


MORE PAGE $CO 


Mnemonic 


Q7 06 ACTION 


clear READ 

set SENSE 
clear WRITE 
set LOAD 


PAGES $F8 - $FB 
Mnemonic 


PLOT 
HLINE 
VLINE 
CLRSCR 


CLRTOP 
GBASCALC 
NEXTCOL 
SETCOL 


SCRN 
PRNTAX 
PRBLNK 
PRBL2 


STEP 
REGDSP 
PREAD 
INIT 


SETTXT 
SETGR 
SETWND 
BASCALC 


BELL1 
BELL2 
ADVANCE 
VIDOUT 


Disk stepper phase 0 OFF 
Disk stepper phase 0 ON 
Disk stepper phase 1 OFF 
Disk stepper phase 1 ON 


Disk stepper phase 2 OFF 
Disk stepper phase 2 ON 
Disk stepper phase 3 OFF 
Disk stepper phase 3 ON 


Disk main motor OFF 
Disk main motor ON 
Disk Q6 CLEAR 

Disk Q6 SET 


Disk Q7 CLEAR 
Disk Q7 SET 


Plota block on LORES screen 


Draw a horizontal LORES line 
Draw a vertical LORES line 
Clear full LORES screen 


Clear topof LORES screen 
Calculate LORES base address 
Increase LORES color by three 
Set color for LORES plotting 


Read color of LORES screen 
Output A then X as hex 
Output three spaces via hooks 
Output X spaces via hooks 


Single step (old ROM only!) 
Display working registers 
Read a game paddle 
Initialize text screen 


Set up text screen 

Set up LORES screen 

Set text window to normal 
Calculate text base address 


Beep speaker if ctrl G 

Beep speaker once 

Move text cursor right by one 
Output ASCII to screen only 
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Table 3-1 Cont. Important Monitor, DOS, and ИО Locations 


PAGES $FC – $FD 
Mnemonic 


BS Backspace screen 

UP Move screen cursor up one 
VTAB Vertical screen tab using CV 
VTABZ Vertical screen tab using A 


Е$С1 Process escape movements А-С 
CLREOP Clear text to end of screen 
HOME Clear screen and home cursor 
CR Carriage return to screen 


LF Line feed to screen only 
SCROLL Scroll text screen up one 
CLEOL Clear text to end of line 
WAIT Time delay set by accumulator 


RDKEY Get input character via hooks 
KEYIN “Read the Apple keyboard 
RDCHAR Get key and process ESC А-Ғ 
CANCEL Cancel keyboard line entry 


GETLNZ CR, then get kbd input line 
GETLN Get input line from keyboard 
GETLN1 Get kbd input, no prompt 
CROUTI Clear EOL then CR via hooks 


CROUT Outputreturn via hooks 
PRBYTE Outputfull A in hex to hooks 
PRHEX Output low A in hex to hooks 
COUT Output character via hooks 


COUTI Output character to screen 


PAGES $FE — $FF 
Mnemonic 


MOVE Move blockof memory 
VERIFY Verify block of memory 
LIST Disassemble 20 instructions 
LIST2 Disassemble A instructions 


SETINV Print inverse text on screen 
SETNORM Print normal text on screen 
SETVID Graboutput hooks for screen 
XBASIC Goto BASIC, destroying old 


BASCON Goto BASIC, continuing old 
TRACE Starttracing (old ROM only!) 
WRITE Save to cassette tape 

READ Read from cassette tape 


PRERR Print “ERR” to output hook 
BELL Output bell via hooks 
IORESR Restore all working registers 
IOSAVE Save all working registers 


OLDRST Old reset entry, no autostart 
MON Enter monitor and beep spkr 
MONZ Enter monitor quietly 
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As you tear into your target program, go through each and every subroutine 
call and find out what it points to. If there are a few locations that are unexplain- 
able, wait till later on these. Just be sure that you pin down as many subs as you 
can. 

Now is a good time to start a separate list of which addresses go where. Label 
this list "Cross References" and show the sources of all subroutine calls. As you 
go along, any time that one part of the code refers to another part, add it to this 
list. Once again, do this by hand, even if you have an automatic cross-reference 
program available. Eventually, you will want this list in numeric order, but for 
now, just list addresses as you run across them. 


PAINT ALL ABSOLUTE JUMPS PINK 


Ready for a new color? Get the pink highliter and add a pink line for any abso- 
lute JMP code ($4C) or relative JMP code (%6С). Draw the pink line all the way 
across the sheet for in-action jumps starting just beyond the address. Draw the 
pink line from the address to only about an inch past the operand for absolute 
jumps that go out of the action. End these lines with half an arrowhead like you 
did with the subroutine calls. 

If the jumps are inside the action, then also put a pink line showing where the 
jump hopped to, just like you did with the subroutines. The jumper and jumpee 
may be connected vertically along the left-hand edge, but do this only if the two 
are less than twenty lines apart. Also “vote” on the most popular jumps, with 
dots if you see more than one jump going to a single location. Add all jumps 
to your cross-reference sheet. 

If the jump is outside the action, use Table 3-1 to try and find out where the 
jump is going to. Then, label the jump using a brown felt-tip pen. 

Here are the two steps that are involved in pinning down an inside-the-action 
jump ... 


20 IF ВЕ JSR 
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An outside-the-action jump looks like this . . . 


Notice what is happening? The //ow and structure of our program is rapidly 
becoming obvious. We already have all sorts of hints as to which part of the 
action does what. But, we are still nowhere near enough ready to tear into the 
code. 

On an indirect jump using the ($6C) code, go to the address shown in 
parentheses and identify this as an indirect address, and show the location that 
is using it for the indirect jump. 

Let's hack away at our structure some more. 


SHOW THE BRANCHES IN BLUE 


Get out the blue page highliter and paint each branch (BCC, BCS, BMI, BEQ, 
BNE, BPL, BVC, BVS, but not BIT or BRK) and its address blue. Then, go to that 
address and enter a blue line on the left. Finally, if the branch is less than twenty 
lines up or down, show the branch action with a blue felt-tip pen. Show the 
direction of each branch, and keep any branch lines from crossing. 

Here is an example... 


BLUE 
HIGHLITER 


FC (monitor VTAB Z) 


FELT TIP 


“Е you find branch lines that try to cross each other, draw the problem line 
up the right-hand side of the address column or elsewhere as needed. It is very 
important to be able to glance at the listing and tell immediately which branch 
goes where. 
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We are really into our structure now. Here, the arrows jump forward, condi- 
tionally skipping part of the code. Often, the arrows will go backwards, outlining 
a block of code called a /oop. The loops visually leap out at you. Check the big 
one at $9298. Note that there can be more than one tail connected to any given 
arrow. 

Three refinements. The first thing is to watch out for possibly irrational code. 
If you are in doubt, paint only the mnemonic blue. The second is to label 
branches directly to RTS as an RTS, rather than showing the arrows. Finally, very 
long branches should show each end separately, to keep from getting too many 
lines on the sheets. 


SEPARATE THE CODE MODULES 


FROM THE STASHES 


Now, carefully, look over the action and identify each “holistic” and “тайоп- 
al" code module. A code module should have at least one obvious entry point 
and at least one obvious exit point. Any question marks or lister mixups at the 
beginning of each module should be resolved so that we can exactly identify the 
boundary of each code module. 

Then, label carefully in red all the external entry points that you know about, 
and any locations that the instructions refer to. Our “cold” entry point is appar- 
ently “ØR” which translates to the first code byte at $8DFF. The "warm" entry 
point is apparently “3R”, or $8E02. The version number is at "6R", or $8Е05. 
We see ап “QA” here, which apparently stands for version 1.9. 

The “R” mentioned above may be new to you. The “R” means "relative" and 
is used with relocatable programs. “ØR” is the first byte in the program, regard- 
less of where it sits; “3R” is the third byte, and so on. 

By the way, if some of our example codes don't exactly fit your listing, 
compare the version numbers. Usually, a different version will move parts of the 
code up or down a few slots from where they first were. 

Here's what this new stuff looks Ке... 


RED FELT TIP 
АС OE ВЕ JMP $8EOE COLD ENTRY 
4C 1Е ВЕ JMP $8ElF  WARMENTRY 
OA ASL (Version 1.0) 


??? я 
BROWN FELT ТІР 


Note that the ASL mnemonic is meaningless since we have a very short stash 
here holding the version number. A mnemonic is only meaningful when applied 
at exactly the right place in working code. 

While you are labeling outside entry points, be sure to check the top of page 
Three for warm start, breakpoint, IRQ, NMI, and RESET vectors. These may 
point to important starting or recovery portions of your code. Many newer 
programs will RESET to themselves, rather than to the monitor. The RESET and 
soft start pointers сап be a great help in showing you where the “high level" 
code sits. 
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Since HRCG is a utility or a service type of support program, it doesn't mess 
with the page Three hooks. But this is an exception, so always check. 

OK. Separate your modules and identify all the external access hooks. Identify 
everything else that you know for certain from the program instructions. 

What is left in the action consists of code modules as yet undiscovered—dead 
code, garbage, stashes, or oversights. 

Dead codeis code that is never used. Don't throw any away just yet, because 
it will most likely come to life later. This can happen because you have yet to 
discover some address entry points or else have missed coloring something 
along the way. 

A lot of programmers will leave dead code in their programs so that the next 
code module or file can start off nice and neat on an even page boundary. Dead 
code may also be some location that will be written to later by DOS. Dead code 
will usually be completely rational, but it won't seem to tie in with the rest of 
the program. 

Do not prejudge garbage. It may become most meaningful later on. Most 
programmers try to shorten their code as much as possible, so if it looks like lots 
of garbage is left, chances are you haven't gotten as far as you think. 

Stashes are short code files that have meaning. We will attempt to identify 
many of them in the next section. 

And oversights, of course, are your own doing. 

We now should have identified all of the working code modules, and should 
be able to find most of their access and entry points, their interaction, and their 
exits. Now, we could actually start to think about tearing into the code. 

But no, not yet. Lots of details still remain. Remember that the /onger you hold 
off on finding out exactly what the code does, the easier the job will get, and 
the /ess of it you will have to do. 

Let's see what Ше stashes and files have to say . . . . 


IDENTIFY FILES AND STASHES 


We have a sort of a chicken-and-egg problem. We can't tell yet what the files 
are up to since we don't know yet how the program works. And, since we don't 
know how the program works, the program can't tell us yet what the files are 
up to. 

Fortunately, there are several С/е filters you can apply that can isolate most 
of the stashes and bulk files and tell you their meaning and intended use. Crack 
your files and you have made a tremendous progress. 

Even if you can only crack a few files now, doing so is definite progress, and 
allows moving bytes from the unknown to the known. This is very much like a 
big picture puzzle. Not only does each piece fit somewhere, but it also gets 
removed from the pile of unknown remaining pieces. This makes identifying and 
using the rest of the pieces easier since there are now less of them. 

Let's isolate all the rational code modules and assume that everything left is 
a stash. Things may not be nearly this simple, but let's try it anyway. Fig. 3-9 
shows us the remaining stash locations. 

When you think you have a stash identified, put a narrow yellow stripe up 
the extreme right-hand margin, going over the tractor holes. Eventually, you 
want to end up with a continuous wide line up and down the right-hand side, 
wide yellow for fully known and understood stashes, and wide green for fully 
known and understood code modules. When the last of the white right margin 
disappears, you have conquered your target program. 
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592ҒЕ 


САНВАСЕ 


392ЕВ 
НІНЕ5 
BASE FILE 


$92DF 


ADDRESS 
FILE 


$8F7D 


Fig. 3-9. Separating HRCG stashes from 


58Ғ48 code modules. 


$8E73 


WORKING 
FLAG FILE 


ASCII 
HEADER FILE 
USER 
SUB FILE 


We see a two-slot stash at $8E05, and then another obvious one starting at 
$8E42 on your listing. But, wait. The "vibes" of our stash change dramatically 
at $8ESF. Let's assume we have a second stash starting there. Put a brown dotted 
line all the way across between $8E5C and $8E5F to remind us we think we have 
two separate files. The second stash apparently ends with $8E73, since $8E74 
holds what looks like rational code, even though this code doesn’t seem to be 
isolated yet. , 

We һауе а long stash starting at $8F48, obviously consisting of lots of question 
marks and the patently excessive use of BCC branches to dumb places. Where 
does this stash end? It’s not obvious at first, but let’s guess that it ends with 
$8F81. The code starting at $8F82 (that we aren’t supposed to be reading yet) 
says to put something т $8E60 and then return. This is rational thinking, particu- 
larly since $8E60 is a slot in another stash and it might end up as a flag in a flag 
file. 

Another stash starts at $92DF, identified by lots of zeros. Again, notice a 
change of vibes at $92EB. The first twelve locations are in three groups of four 
each and all end in zero. The remainder of the stash is strange. Let's call it two 
separate stashes and, once again, add a dotted brown separation line. 

Now comes the tricky part. First, we want to guess what each location in each 
stash is used for, and, then, we want to nail each location down for sure. 

To do this, make yourself up some file and stash fi/ters. A stash filter is some 
test for some pattern that makes sense to you and to the particular target program 
you are on. The filter is valid if its answer leaps out at you and is clinched by 
some independent test. 


$8bE5F 


$8Е42 


$8EOB 


$8DFF 
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Normally, you will have to design these filters yourself. Do so very carefully. 
Your choice of filters will vary with the target program and how long it is. Here 
are some obvious filters to try first... . 


STASH AND BULK FILE 
FILTERS 


() Is it something obvious? 
( ) Is it an ASCII string? 

( ) Is it a table of addresses? 
( ) Is it a group of flags? 

( ) Is it a conversion table? 
( ) Is it DOS related? 


( ) Does it fill a program need? 


These are the usual filters | try first and the order in which I try them. The HRCG 
is very accommodating in its stash uses. The early tests will tell you a lot about 
each stash. Other programs may not be so easy. 

We attack the chicken-and-egg problem this way. First, we filter the stashes 
and bulk files as best as we can to find out as much about them as we are able. 
Then, we take this information back to the code modules and see what new thing 
this tells us about the modules. Then, we look into the modules and see what 
they tell us about the remaining unknown files. 

Three or so trips round and around and we should have things pinned down 
fairly well. Now, if you are into an Adventure or something else really heavy 
with stashes and bulk files, it won't be this simple, but file filtering always makes 
a very good starting point. 

Let's try these filters one by one and see what they tell us. 

One example of an obvious file is any code on a display page. This might be 
$0400-$07FF for text or LORES page One, $0800-0BFF for the less common 
text or LORES page Two, $2000-3FFF for HIRES page One, or $4000-$5FFF 
for HIRES page Two. If any of these pages are in use, the bytes stored here have 
to correspond to the image on the screen. 

Note that the screen images will change as the program is used. What you 
see is the code for the display pages at the exact point in the program where 
you did your listing. Chances are that text page One got messed up by the listing 
process itself. 

Besides their obvious location, the HIRES color bytes tend to be mostly $00, 
$2A, $55, $7F, $80, $AA, $D5, and $FF bytes. In HRCG, we can often ignore 
these for a while, since they are the resu/t of the program and not a part of it. 

Another example of obvious code happens when you are reading interpreted 
BASIC statements. We'll save details on this for another time. But note that the 
basic byte patterns are distinctive, starting with a line number, followed by the 
location of the next program line, and, then, followed by a parsed code using 
token keywords and ASCII symbols, and, finally, ending up with an end-of- 
statement symbol. You can check into the LOADHRCG Applesoft program for 
a quick example. Do this by hex dumping machine code starting at $0800. 

Usually, the BASIC code tells you that you are looking in the wrong place. But, 
machine language is sometimes stuffed inside BASIC programs and, at other 
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times, it will interact directly with the BASIC statements. This happens іп the case 
of fast sort routines, variable locators, cross-reference programs, and so on. 

As а much simpler and shorter example of an obvious file, look at $8Е06. It 
is two bytes long. Is it an address? The address is $92FF. Is there anything special 
about $92FF? 

There sure is. 

This is the location of the start of the bulk file that we think is an alternate 
character set. Since we obviously need a pointer like this and since a pointer 
would be early in the program, let’s assume this stash is the pointer to the 
character set start. 

Make sure any "obvious" evidence is very strong. Don’t make wild guesses, 
and don't make too many guesses at once. Above all, don't force things to fit 
your pet theories about what a stash “has” to be. In this case, guessing ап 
address and having that address reinforce our guess is reasonable. 

Next, try some ASCII filters. The ASCII code is the standard way of stashing 
letters, numbers, and punctuation in your Apple. Table 3-2 shows us the ASCII 
code. An ASCII-coded stash will be mostly code starting with $CX or $DX, will 
һауе a few %А0 spaces thrown іп, and will often end with а $80 carriage return. 
This assumes, as most Apple programmers do, that the ASCII most-significant 
bit is set to a 1. If the MSB is not set, then an ASCII file will be mostly values 
in the forties and fifties, with a $20 for each space, and with a $0D carriage 
return ending. If the file is mostly lower case, then the code will be mostly “ЕХ” 
and “ЕХ” values for a set MSB and “sixties” and “seventies” for a cleared MSB. 

The actual display code used by the Apple on its upper-case-only old text 
screen differs slightly from ASCII. This code is shown in the Apple manual. The 
code provides for no control characters and offers normal, inverse, and flashing 
upper-case-only characters. 

Programmers rarely use this vídeo display code inside their programs. In- 
stead, they usually will use ASCII, and set and clear the flashing and inverse flag 
(location $0032) as needed. The video display code can only be written directly 
to the screen and must not be output to any other device via the output hooks. 
The code would get used in a program only if the text display needs a wildly 
changing mix of flashing, inverse, and normal characters, and, then, only if the 
upper-case-only text screen is the only intended output. 

Note that ASCII text is automatically converted to video display code by the 
usual monitor routines as it goes onto the screen. 

Now, any file will give you some message back if you filter it for ASCII. The 
key test is whether the message says anything meaningful. You can ASCII filter 
all your stashes and bulk code, but it pays to pick only the most promising ones 
first. 

In the case of the HRCG, we see that the stash beginning at $8E42 looks the 
most promising. ASCII filter this code and you get . . . 


«dle» HI-RES CHAR GEN VERSION 1.0 «cr» 


This is obviously the prompt message that first appears under HRCG. The odds 
of it being anything else are insanely small. 

Note as you "crack" a stash, that it no longer belongs to the unknown. 
Further, a cracked stash will greatly simplify tearing apart the actual code, for 
we can now assume the code module directly above it on the listing will be 
involved in printing out this message. 

As you get practice, you'll be able to immediately spot stashes and bulk files 
that will yield useful messages under ASCII code. Be sure to do this by hand a 
few times until you get the feel of this powerful filter. 
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Table 3-2. ASCII Code 


NUL SOH 5ТХ ETX EOT ENQ ACK BEL BS 


DLE ОСІ DC2 DC3 ОС4 МАК SYN ETB CAN 
% & 
5 6 
E F 


We'll look at some short and powerful ASCII “snoop” programs in a future 
enhancement. Commercial programs that list ASCII strings can also be used. But, 
watch out that loading the snoop program doesn’t bomb part or all of your target 
code. For now, do your ASCII snooping by hand till you are able to spot an ASCII 
file at a casual glance. 

The acid test of an ASCH filter is whether you get a message back or not. Once 
again, don’t force things. If the filter doesn’t hit you over the head with the 
answer, try something else. 

If the message seems fragmented or disjointed, possibly you are looking at an 
area that gets written repeatedly by DOS—putting message upon message on 
top of each other. A copy of the keybuffer from $0200-$02FF may also look 
the same way. In either case, you are far more interested in the use of this file, 
rather than its contents. 

Our next trial stash filter should answer the question, "Do we have a list of 
addresses?” Look at the stash starting at $8E5F. A bunch of zeros, with a $92FF 
in it. Recall that 92FF points to the start of the default character generator. Do 
we have a file of alternate character sets here? 

It doesn’t look like it, but those zeros suggest a test. Let’s run the HRCG and, 
then, let’s load nine alternate character sets. Then, we will see how and if this 
stash changes. 

Try it and there’s no change! This should teach us several things. First, always 
be sure you have what you think you have in the machine. Second, be sure and 
try any trick you can think of, even if it doesn’t work. 

Third, and most importantly, NEVER force anything to fit your pet theories. 
The address filter clearly fails on this file. We'll discuss this stash in more detail 
later. 

Let's try an address filter on the next stash starting at $8F48. Every second 
entry is either a $8F or a $90. Look at it on the hex dump and the addresses 
leap out at you. Color every second address pair yellow on your hex dump. Note 
that the addresses sit backwards on the dump, with the high byte second and 
the low byte first. This low-byte-first style is typical of most 6502 machine- 
language addresses. 
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It looks like we definitely have a table of addresses. For the clincher, check 
to see if the addresses all go somewhere rational. And, we have another surprise! 
Each and every address goes right in the middle of the code all right, but each 
one seems to point to an extremely dumb place! 

Let's break our rule on tearing into code for a moment and see what code we 
find immediately above this address table. In this code module, we take a value, 
multiply it by two and, then, use it as an X index to get the high address in $8F3C. 
This high address gets shoved onto the stack. Then, we get the low address at 
$8F40 and shove it onto the stack also. Then, we return from the subroutine. 
What we have really done is we have faked an indirect jump to the selected 
module. 

Now, what does a subroutine return do? It pops the stack twice and goes to 
the address it thought it came from. Only we just changed that with the address- 
low and address-high stack pushes. Note that two pushes and two pops left the 
stack exactly where we started. Our new code module is, therefore, at the same 
level that we were before, so we have done an indirect jump, rather than a JSR. 

Ah! But, a subroutine return does not return to the address on the stack. It 
returns to the address on the stack p/us one! This quirk is from the 6502 
Programming Manual. Now, let's try adding one to each address and see what 
happens .... 


$9046 + 1 = $9047, an immediate RTS. 
$8F7D -- 1 — $8F7E, a royal mess. 

$8FA9 -- 1 — $8FAA, the start of a subroutine! 
$8FD1 -- 1 — $8FD2, the start of a subroutine! 
$8FEC 4- 1 — $8FED, the start of a subroutine! 
$901A + 1 = $9018, the start of a subroutine! 


etc... 


Keep this detective work up, and we find that each address, except for the 
first two, points to a subroutine. The first one, an immediate return, looks as if 
it is a mistake. 

What about the royal mess? Here is a classic example of our lister getting off 
on the wrong foot. Right now, the lister says . . . 


STA (BO),Y 
BIT $A9 


??? 
5ТА 58Е60 
кт5 


We know Ше first part of this is wrong, since we have stashed addresses and 
not working code here. We suspect the end of the listing may be right, since it 
seems rational. Our problem address is trying to point to $8F7E, so let's let it 
do so. Relist things starting with $8F7E, and you get . . . 
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BCS $8РА4 


LDA #$80 
STA $8E60 
RTS 


And this is a nice and rational little subroutine. Our problem mess was solved 
by making sure our lister had something worth listing as its first entry. 

Wow, what a bit of detective work. Our filter has found 27 addresses that lie 
in the middle of our code, all of which point to valid and workable subroutines, 
except for the first one that immediately returns. 

Let’s carry this further to see what an address stash will tell us about those 
subroutines. Now, 27 is one more than 26, the number of letters in the alphabet. 
Look at the ASCII code given back in Table 3-2, and we see a sequence of 
(QABCDEF . . . that jumps out at you. If the program was using a pointer that 
started with @ for a 00 value, we would have 27 values, the last 26 of which 
would be the alphabet in order. Naturally, (Q wouldn't be used, so it would 
immediately return. 

Let's take a wild guess that (Q — Address 0, A — Address 1, B — Address 
2, and so on. Now, let's see if this heads to any place that is useful. 

Back to the HRCG manual. We have two sets of A to Z commands. This 
strongly suggests trying to fit the menu selections to the subroutines we already 
have. Right now, this is sort of a wild guess. But, if it works, and if we can prove 
it absolutely, we will have chopped mucho time off of our target-program attack. 

Let's look further. Put a brown arrow at each subroutine's starting address that 
we think does something from A to Z. We get strong reinforcement right off the 
bat since all of them start off on a new code module. 

We also notice something rather strange. Each and every module starts off 
with either BCS or BCC. 

Odd. 

But, remember that there are two alphabets needed in HRCG, one for the 
main menu selection and one for the option selection. Let's continue, since 
everything has been reinforced so far. Apparently each subroutine is a subrou- 
tine pair, one of which handles the “main” menu selection and one of which 
handles the “option” menu selection. Further, the condition of the carry flag tells 
us which way to go. 

Which is which? To find out, we'll need more detective work. 

Note that we have a function selection “Е” but no option selection “Е”. Note 
also that we have an option selection “R”, but no function selection “R”. Go 
to the sixth address on the list (E is the sixth character starting with @), and we 
see a BCS to RTS. Apparently a c/eared carry is a function and a set carry is an 
option. 

Even more important, look at that monitor subroutine clear-to-end-of-screen 
leaping out at you at $9028 on your program listing. This is a solid and complete- 
ly independent check on what these addresses are used for. 

As a final check, we look at entry “R” (the fourteenth address), and we see 
a BCC to RTS, verifying that the carry flag decides which alphabet to use. The 
code at “R” should "Reverse the overlay” for us. A quick look at this code 
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shows it setting two flags for us—another confirmation. This confirmation is 
much weaker than the first one, but support is support. 

So, go through all your code addresses and label their uses with a brown 
felt-tip pen. Use fairly large letters. $8F7E should be labeled “(А) function 
SELECT М”. Check the BCS branch location and the code starting at $8FA4 gets 
labeled (А) option PAGE 1 PRIMARY", 

Continue through the list. The modules that use the cleared carry are func- 
tions, and the ones that use a set carry are options. 

Note the power of the address filter. We now know the meaning and use of 
well over half of the code modules, without tearing into the code at all. HRCG 
is very friendly with its menu-driven selections. In other programs, you may not 
be able to immediately tell one address-code module from another. But the very 
fact that you can break up the modules into little chunks is extremely valuable 
and a major time saver. 

The usual clue to filtering address tables is that every second entry is the same 
and the backwards entry pairs seem to be working through a range in a usually 
increasing order. 

The HRCG stash at $8F48 seems to be the only table of addresses we have, 
so we will try some new filters. 

Our next trial stash filter asks, “По we have a group of flags?” A flag is some 
location that the program refers to so that it can decide what it is going to do 
next. In the HRCG, we can expect flags for the display page, the primary page, 
the working alternate character-set base address, the display mode, and so on. 
In an "adventure" program, the group of flags can show what is in which room, 
whether the giant armadillo is asleep or awake, whether the golden clockwork 
canary can be wound, and similar conditional things. 

A flag file will often be mostly zeros, with a few FF's thrown in here and there. 
Other hex bytes in a flag file may have only a single bit set, such as $01, $02, 
$04, $08, $10, $20, $40, and $80. Flag files may also hold an occasional 
address or two. 

One good way to verify a flag file is to find some stash that looks reasonable, 
and then /ightly scan nearby code modules to find if there are references to 
these locations. п the HRCG, we see a likely file starting at $8ESF. A check 
through some of the option code shows lots of them working with locations 
$8E5F through $8E73. 

There's usually a two-step process involved in understanding a flag file. First, 
you prove the flag file is there and that it is used. Then, later, when you are 
checking into the variables of the program in the next section, you attempt to 
put specific meaning onto each and every flag. | 

Pinning down flag meanings сап be quite a challenge. Тһе original рговгат- 
mer started with his flag definitions and locations and, then, built his program 
around them. You have to do the opposite, taking strange code and inferring 
what the flags originally stood for. 

Our “15 it a conversion table?” filter is one that takes some experience to use. 
A conversion table relates addresses to data in some manner. Table lookup is 
a very fast way to do things, compared to calculating values. The stash starting 
at $92DF "looks" somewhat like a conversion table that somehow “seems” to 
be involved with HIRES (high resolution) base addresses. We'll keep this one a 
"maybe" for now. : 

Other examples of conversion tables are the shape tables and sprite maps 
used in HIRES graphics. A shape table holds a bunch of drawing directions, as 
needed, to directly write on the HIRES screen, using Apple's graphics routines. 
A sprite map will hold an image of what is to be remapped onto a HIRES screen. 
A character from an HRCG character-set file is an example of a sprite map. 
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Let's continue down the file filter list. Many machine-language programs 
create their own DOS, or else, use DOS variations for protection, access, and 
50 on. In these cases, there are some DOS filters you can apply to your stashes. 
These DOS filters do not seem to help us here on the HRCG. 

A file involving DOS may consist of bunches of code always ending in $X0 
or $X8. These are used in the DOS nibble encoding. DOS code modules will 
often use header constants of $D5, $AA, $96, markers of $DE, $AA, $EB, and 
a trailer of $DE, ФАА, and $EB. These values will jump out at you once you tune 
yourself into them. DOS code will also repeatedly use LDA %С08С,Х com- 
mands, followed by a BNE back to itself. “X” here is the slot number. This looks 
real dumb when you first see it, but it is a sure sign of DOS read activity. 

Another way to filter a file is to ask, “Does it fill an obvious program need?" 
You'll have to design suitable filters for each and every target program. Let's take 
a closer look at our bulk file and see what we can find out about it from its 
structure alone. 

Visual clues can help bunches here, such as the frequency of repetition of 
some marker. In Zork, the vocabulary file has a zero and, then, six bytes, over 
and over again. The “objects” file takes nine bytes and is in the form of seven 
flags and an address. Look for these patterns. Break up a file into several smaller 
files whenever you see any change in these patterns. 

Even if you don't have the foggiest idea about what is in the file or how it is 
used, deduce as much as you can about the file structure, for this will be a great 
help later. 

We suspect our bulk file is a default character set. All right. That means that 
the bits should look like characters if you arrange them just right. We know the 
characters are arranged in 7 х 8 squares from the ANIMATRIX program. So, 
a reasonable "Does it fill a program need?” filter on this bulk file is making sure 
to look at each and every bit and see if there is some visual pattern that looks 
like character dots. Let's start at $9700... 


($00) — ооооооо 
($00) — ооооооо 
($00) — ооооооо 
($00) — oooooco 
($00) — ооооооо 
($00) — 2000000 
($00) — 0000000 
($00) — 2000000 
Now, that one is singularly uninformative. Yet, it is the first character and we 


know that the first noncontrol character in ASCII is a space. Let's try another one 
at $9307. 


($08) — ООООХОО 
($08) — cooeooo 
($08) — ООФООО 
($08) — оооФооо 
($08) — ООФХОО 
($00) — ооооооо 
($08) — oooecco 
($00) — 0000000 
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Now, that looks like an exclamation point, the second printing ASCII charac- 
ter. But, things are still weak. Let’s try to predict a quote for the next one, starting 
at $930F. And, sure enough . . . 


($14) — ooeoeco 
($14) — ooeoeco 
($14) — ooeoeco 
($00) — ocooooo 
($00) — 2000000 
($00) — oooooco 
($00) — ооооооо 
($00) — ocooooco 


Apparently the characters are in the character file in order, just like they go 
on the screen. Only, we may be jumping to conclusions. Let's try several more 
characters. There are 96 characters, each of which takes up 8 bytes, so we can 
expect 768 bytes total, or exactly 3 pages. Thus, we would expect the numbers 
and punctuation to start at $92FF, the upper-case alphabet at $93FF, and the 
lower-case alphabet at $94FF. 

To prove this, we would expect a capital “А” to be at $93FF + $08 = $9407. 
Try it, and lo and behold . . . 


($08) — oooeocco 
($14) — ooeoeco 
($22) — oecooeo 
($22) — ОФООФО 
($3E) — ceeeeeo 
($22) — oecooeo 
($22) — oecooeo 
($00) — 2000000 


So, obviously, we know everything that we should know about the bulk file 
now, right? 

Wrong! 

One very important rule... . 


No matter where you are in 
cracking a file, there is ALWAYS 
one surprise remaining between 


where you think you are and 
where you really are. 


THE FINAL 

SURPRISE IS 

THAT THERE ARE 

NO MORE SURPRISES! 


Always, check things as independently and as completely as you can before 
convincing yourself that something is so. In the case of our bulk file, the surprise 
comes on the next character. 
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($1E) — coeeeso 
($22) — ОФОФО 
($22) — оФоооФо 
($1E) — coeeeso 
($22) — ОФОООФО 
($22) — ОФООФО 
($1E) — ooeeeso 
($00) — coooooo 


Uh — whoops. That's a B all right, but why is it backwards? All the rest are 
obviously frontwards, aren't they? Let's try the next character . . . 


($1C) — ooeeeco 
($22) — oecooso 
($02) — ОООСФО 
($02) — СОООФО 
($02) — ООХОФО 
($22) — oecocoso 
($1C) — oceeeco 
($00) — ооооооо 


Hmmm ..., the "C" is also backwards. But why would some characters be 
frontwards and some backwards? 

They wouldn't. 

The first three characters that we looked at just happen to look the same 
frontwards or backwards. That's the prize we find in this particular box of 
Crackerjacks. 

Apparently all of the characters are “backwards” with the least-significant bit 
going out to the display first and the most-significant bit going out to the display 
last. Think about this for a while and you'll remember that a backwards entry 
is also how all of the HIRES color routines work, so we should have expected 
something like this. 

Fig. 3-10 shows us the final arrangement of the default character set in the 
bulk file. We can safely assume that all other character sets will behave the same 
way, even though they are located elsewhere in memory. 

Now, a visual bit-by-bit check of a long file may turn out to be totally worth- 
less. But, it also may be a sure clue that will permit quickly cracking most of the 
program code. However, it all depends on the program and how creative your 
cracking approach is. What you have to do is make up a “Does it fill a program 
need?” filter that might show you something. But, keep trying things that are 
geared to the target program until something leaps out at you and hits you over 


the head. 
THE ULTIMATE FILE FILTER 


There is one ultimate file filter . . . . 
Fill the file with water and 


see where it leaks. 
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95Ғ 
*oSFE FORMULA TO FIND ANY CHARACTER: 


STARTING ADDRESS = 592ҒҒ + 8+(ASCII — $20) 
(WHERE ASCII = НЕХ ASCII VALUE OF CHARACTER) 


EACH CHARACTER IS STORED AS EIGHT SEQUENTIAL BYTES. 
THE FIRST BYTE HOLDS THE DOTS FOR THE TOP ROW OF THE 
CHARACTER. THE LSB OF EACH BYTE IS THE LEFTMOST 
DOT ON THE CHARACTER. THE MSB IS USED FOR OPTIONAL 
HALF-BIT SHIFT OR COLORCHANGE AND ISNOTDISPLAYED. 
BOTTOM BYTE IS USUALLY BLANK, EXCEPT FOR LOWER- 
CASE DESCENDERS. 


$94FF 


MSB LSB 
+ 


59396 


$93FF 


NUMBERS $938F 
AND 
SYMBOLS 


THAT'S A “2” 


$92FF 


Fig. 3-10. How the HRCG default character set is stored in the bulk file. 


If all else fails, and you are making reasonable progress elsewhere in your 
attack, try changing some or all of the contents of a file and see what changes 
take place in the program. 

Usually, the program will bomb on random file changes. But, by finding out 
where and when it bombs and, then, zeroing into one or two locations in our 
target file, we can sometimes find out lots of things in a hurry. 

Suppose we didn’t know our bulk file was an alternate character set. If you 
made the first eight bytes all $FF’s instead of $00’s, then all the spaces in any 
message would be white boxes, but nothing else would change. Now, this would 
immediately tell you that the file was a character set and that the first entry was 
a space. 

Another neat example of this is to go through the movable object file in an 
Adam's Adventure and change all the room numbers to БЕР. You are now 
carrying...... everything! 

The only unexplained file left in HRCG is the stash starting at $92EB. Now, 
this code seems downright weird and has failed all the other tests. The code 
could be garbage since it is at the very end and since the character generator 
sets all have to start at the same base address. 

Fill this file with $FF’s and what happens? 

Nothing. 

There is no change in any part of HRCG that is immediately obvious. So call 
it garbage. 

At this point, you should have all your stashes and all your bulk files separated 
and many of them fully identified. 
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Back to the code modules . ... 


ATTACK VARIABLES AND CONSTANTS 


Start a fresh page on your quadrille pad and head it "LIST OF VARIABLES." 

Now, go through the code modules line by line, and each time you find an 
address used for loading, storing, BIT testing, logic operations, or whatever, paint 
the variables pink and the constants green. 

Note that the constants will always have a # symbol in front of them. Page 
Zero addresses will be two hex digits but no #. Absolute addresses will be four 
hex digits, again with no #. 

As an example, an LDA $05 puts what is in page Zero memory location $0005 
into the accumulator. This is a variable. It is a variable since the contents of 
$0005 can have any of 256 values ranging from $00 through $FF. But, an LDA 
#$05 puts the каше hexadecimal $05 into the accumulator. This is a constant 
equal to “five” of something. 

Watch for that # symbol! It will get you every time if you ignore it. 

Our first code module starts at $8E1E. Your variable and constant lines should 
look like this . . . 


GREEN = 


S8ElF- A9 74 


58Е21- 85 38 


ОЛЕНИ (low address 74) 
GENES (косу!) 


RED A ы BROWN FELT ТІР 


As you identify variables and constants, you can start tearing into code. But, 
if something isn’t immediately obvious, go on elsewhere. Our first object here 
is getting a list of all locations that get used for target-program variables. Howev- 
er, if we can find the meanings at the same time, we are just that much further 
ahead. 

The code starting at $8E1F is very easy to read. First, we set the input hook 
to $8E74 and, then, we set the output hook to $8F18. Next, we reconnect DOS 
to internalize these hooks. Then, we switch to the full graphics and pick the 
HIRES mode. Continuing, we restore the default display parameters and, then, 
we switch on the graphics mode. Finally, we exit. 

How did we figure all that out? Look back at what we know about these 
variables. . . . 


$38 апа $39..... аге the KSW switches in the monitor. 
$36 and $37..... are the CSW switches in the monitor. 


FROM TABLE 3-1 $O3EA ......... is the DOS reconnect hook. 


OR PREVIOUS 


$6052: н is the ІШІ screen switch. 


ЖООН vv y < a is the HIRES switch. 
RESULTS у= Sub $9158...... is named ‘‘Restore Default Parameters.” 


Sub $9000 '..... is named “Display Primary." 
$6050 75... ss. is the GRAPHICS switch. 
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Usually, you won't be so lucky on your first try. We now understand that this 
code module is the initialize portion of HRCG. We also now see what it does. 
We add all the above variables to our variables list, and color everything that 
we understand reasonably well pink for a variable or green for a constant. 

Since this module is so obvious, we can also color the right tractor margin a 
solid wide green. 

We also found out something new. All keyboard inputs go to $8E14 and all 
character outputs go to $8F18. So, label these locations in red. Do this and two 
more large code modules now have labels. Call these KEYBOARD ENTRY and 
CHARACTER OUTPUT. 

Continue through the code modules and identify every variable. If you can 
tell exactly what the variable is used for, so much the better. И not, just put the 
variable on the list. The variable will most likely crop up later in another code 
module that may clarify its use. 

Don't go overboard on analyzing code. If something is obvious and simple, 
go ahead and crack the code. If it is not, just record all the variables. Do not 
color any variable or constant till you understand what it is used for. But, be sure 
to get all of them on the list. 

Pay particular attention to variables inside parentheses. A set of parentheses 
means that you are doing a jump indirect or using one of the indexed indirect 


Table3-3. List of Variables for HRCG 


ADDRESS MNEMONIC 


— page $00 — 


WNDLFT Leftend of scrolling window 
WNDWDTH Width of scrolling window 
WNDTOP Top of scrolling window 
WNDBTM Bottom of scrolling window 


Text screen cursor horizontal 
Text screen cursor vertical 

Text screen base address low 
Text screen base address high 


Dot row HIRES base address low 
Dotrow HIRES base address high 
Temporary Y register save 
Character output hook low 


Character output hook high 
Keyboard input hook low 
Keyboard input hook high 
Keyboard delay low 


Keyboard delay high 
Temporary X register save 
HIRES base address low 
HIRES base address high 
Character set base address low 
Character set base address high 
Temporary accumulator save 
— page $01 — 
JSR stack source pointer (, X) 
— page $03 — 


Hookto reconnect DOS 
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Table 3-3 Cont. List of Variables for HRCG 


ADDRESS MNEMONIC 


— page $8Е — 


— page $92 — 


— page $CO — 


IOADR 
KBDSTRB 
MIXCLR 
LOWSCR 


HISCR 
HIRES 
TXTCLR 


— page $FC — 


VTAB 
VTABZ 
CLEEOP 
HOME 
SCROLL 
CLREOL 


Default character set base low 
Default character set base high 
Jump to user sub А 
Jump to user sub B 


Pointer to header message 
Escape key flag 

Alternate character set flag 
Primary page flag 


Inverse video flag 
Transparent video flag No. 1 
Transparent video flag No. 2 
Scrolling flag 


Case flag 

Character set in use base low 
Character set in use base high 
Save of $8E61 while block mode 


Save of $8E62 while block mode 
Save of $8E63 while block mode 
Save of $8E64 while block mode 
Save of $8E65 while block mode 


Save of $8E66 while block mode 
Save of $8E67 while block mode 
Save of $8E68 while block mode 


Block mode flag 


Horizontal cursor position 
Vertical cursor position 
Function address file base low 
Function address file base high 


Start of HIRES pointer file 
Default character file start 


Keyboard ASCII input 
Keyboard strobe reset 
Full graphics soft switch 
Page 1 soft switch 


Page 2 soft switch 
HIRES soft switch 
Graphics soft switch 


Vertical tab from CV sub 
Vertical tab from accumulator 
Clear to end of page sub 
Home text screen monitor sub 
Scroll text monitor sub 

Clear to end of line sub 
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modes. These аге among the most powerful commands Ше 6502 microproces- 
sor has available, so it pays to very carefully understand how these are used. 
It really gets challenging when you get into the double or even triple indirect file 
manipulations that are involved in the longer Adventure programs. 

Don’t worry too much about fuzziness and loose ends. Identify what you can 
and crack what code you can, but Keep moving! And, every time you get a new 
piece of checkable information, go back and plug it in everywhere it seems to 
fit. The ripple effect when you do this is often astounding. 

Our flag file bytes get identified as you go along. Note that $8FA4 puts a $20 in 
8E61 to display the primary page and that $8FCC puts а $40 in $8E61 to display 
the secondary page. We can then conclude that $8E61 is the page flag. 
You can continue this reasoning for the other flags. The block mode ends up 
using the bottom half of the flag file. 

You should end up with a complete list of all variables, some of the code 
completely cracked, and lots of new hints that will help you elsewhere in your 
attack. 

After your list is nearly complete, recopy it legibly in numeric order. Table 3-3 
shows a list of the variables used in HRCG. Use this as an example. 


PAINT THE HOUSEKEEPING YELLOW 


Next, go back through the code. Every code line that uses an implied address- 
ing mode should be painted yellow once you understand it. Implied mode 
instructions use a single op code byte and are not qualified by a value or an 
address. Examples are INX, DEY, TXA, CLD, SEC, TSX, and so on. 

If you happen to have code that uses the stack to hold a value for you, this 
will show up with a PHA, some operations, and, then, a restoring PLA. Show 
these in yellow just like any other implied instruction. But if, and only if, the PHA 
and PLA are irrevocably paired as a temporary store, connect them with a 
yellow bracket. 

Like this . . . 


LDA (S2A),Y 


YELLOW 
HIGHLITER 


($2A),Y 
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Once you understand how a yellow line is used, add comments in brown to 
explain it. Should you get paired PHP and PLP commands, these should also get 
bracketed in yellow, but only if they always work together. 

What you are after here is to have a color on each and every line, a comment 
on each and every line, and, on the right margin of the page, a solid green area 
for each module that is understood, and a solid yellow area for each stash that 
is cracked. 


WRITE A SCRIPT 


Where you are right now depends on your experience and how tough and 
how long the program is. If you try this method on a target program that is only 
a few hundred words long, you should be done by now. You should not only 
have met your limited goal, but should have the rest of the entire program 
completely cracked. On longer programs, the chances are there is lots of white 
space remaining. These white spaces point to uncracked code and unbroken 
stashes and bulk files. 

The next step is to write a script. Explain in people-type words what each and 
every known stash, bulk file, and code module does. 

A complete script of HRCG appears in Table 3-4. Use this as an example. If 
you have to leave blanks for now, do so. 


CUSTOMIZE YOUR ATTACK 


Hopefully, you will know what to do next at this point. Go on your own vibes 
in the most obvious direction. 

Obviously, all machine-language programs are different. Some will involve 
themselves a lot with DOS. Others will use only the HIRES screens for game 
actions. Still others will interact with a host BASIC program, and so on. 

What you now want to do is customize the attack to fit the program. How 
you do this is up to you. Here are some things | sometimes му... 


CUSTOM ATTACK METHODS 


Look for built-in diagnostics. 
Use breakpoints. 

Try flowcharting. 

Attack indirect addressing. 


Add hooks. 

Gain partial control. 
Use the cassette. 
Single step and trace. 


Chip away at it. 


Ask for help. 
Use partial boots. 


Detect changes. 
Alter files. 
Put program on an assembler. 


Attack a similar program. 
Decipher special codes. 
Try something easier. 


() 
() 
() 
() 
() 
() 
() 
() 
() 
( ) Attack the fundamental subs. 
() 
() 
() 
() 
() 
() 
() 
() 
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That’s sure a long list. Not every idea will work on every program, though. 
Let’s look at a few of these in more detail. 


Table 3-4. Complete Script of HRCG 


ADDRESS COMMENTS 


$8DFF Hard entry point. Clears screen and 
prints header, connects HRCG hooks. 


$8Е02 бой entry point. Connects HRCG but 
does not clear screen. 


$8Е05 Version number х 10. 


$8Е06—8Е07 Base address of default character- 
generator set. Defaults to $92FF. 


$8E08—8E09 User subroutine A starting address 
called by option Y. Defaults to 
subroutine return RTS. 


58ЕОВ-ВЕОС User subroutine В starting address 
called by option Z. Defaults to 
subroutine return RTS, 


$8E08—8E1E Hard entry routine. Sets МО hooks, 
then reconnects DOS. Switches to 
HIRES full screen. Restores DOS 
and default parameters. Displays 
primary. Switches to graphics. 


$8Е42-8Е5С Stash holding ASCII-coded title 
and version. Used during cold entry. 


$8E42—8E73 Stash holding all working flags — 


$8ESF -$80if previous кеу ESC 
$00 otherwise 
$8E60 - $80 if alternate characters 
$00 if default characters 
$8E61 - $20 if page 1 primary 
$40 if page 2 primary 
$8E62 -$00ifnormal video 
$7F ifinverse video 
$80 if overstrike video 
$CO if complement video 
$8Е63 - $80 if transparent mode 
$00 otherwise 
$8E64 - $60 if transparent mode 
$00 otherwise 


$8E65 - $00 if scrolling 
$FF if wraparound 
$8E66 - $00 if caps lock 
- $80 if lower case 
- $CO if single capital 
$8E67 - Base add low of set in use 
$8E68 - Base add high of set in use 


$8E69 - Save of $8E61 while block 
$8E6A - Saveof $8E62 while block 
$8E6B - Save of $8E63 while block 
$8E6C - Save of $8E64 while block 
$8E6D - Saveof $8E65 while block 
$8E6E - Save of $8E66 while block 
$8E6F -Saveof $8E67 while block 
$8Е70 - Save of $8E68 while block 
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Table 3-4 Cont. Complete Script of HRCG 


ADDRESS COMMENTS 


$8E71 - $00 И normal display 
$FF if in block mode 

$8E72 - CH horizontal position 

$8F73 - CV vertical position 


58Е74-ВЕАС Enter HRCG via keyboard hook. Save 
A, X, BASH, and BASL. Debounce keyboard 
and flash cursor till key is pressed. 
Reset keyboard strobe. 


$8EAD—8F17 Check keyboard for ESC or CR. If 
a CR, process via sub $928D. If 
an ESC, process |, J, K, M for 
cursor motions. Then, clear EOL if 
Eorclear EOS if F. Process А, B, 
C, and D cursor motions. 


$8F18—8F27 Enter HRCG via output hook. Save 
A, X, and Y. If a number and 
preceded by ESC, change character- 
set number via $8F86. If a control 
command, clear Carry if a function 
and set Carry if an option. If a 
letter from @ to Z, process by 
getting address from stash $8F48 
and doing an indirect jump. 


$8F48—8F7D Stash of 27 addresses for menu 
selections A—F. Selection (2 does 
an immediate RTS. Address picked 
by $8F28. 


$8F86—8FA3 Function A. Alternate character set. 
If a number from 0-9, calculate new 
base address and store in $8E67. 


$8FA4—8FA9 Option A. Put #$20 in flag $8E61 to 
switch to primary page 1. 


$8FAA-8FCB Function B. Begin block display if 
not already there. Put $#FF into 
flag $8E71. Move flags $8E61 
through $8E67 to $8E69 through $8E70 
as temporary save. Move CV and CH 
into flags $8E72 and $8E73. 


$8FCC-8FD1 Option B. Put #$40 in flag $8E61 to 
Switch to primary page 2. 


$8FD2-8FDE Function C. Carriage return. If 
notbelow bottom, do CR via $9204. 


$8FE2—8FEC Option C. Complement display by making 
flag $8E63 a #$СО and $8E64 a 3 $00. 


$8FED-900C Function D. Block display off. If 
in block mode, move flags back to 
$8E61—8E68. Reset block flag and 
CH flag to zero, CV flag to bottom. 


$900D—901A Option D. Display primary. Switch 
to page One. Check primary flag 
and switch to primary flag page. 


59018-9022 Function Е. Clear HIRES page to EOL 
using $928D. Then, clear text page 
using monitor CLEOL. 
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Table 3-4 Cont. Complete Script of HRCG 


ADDRESS COMMENTS 


$9023-902A 


$902B-903F 


$9040—9047 


$9048—904F 


$9050-9057 


$9058-9072 


%9073-907А 


59078-9082 


$9083-908D 


$908Е-9095 


$9096—909E 


$909F—90AD 


$90AE-90BA 


- 59088-90С2 


890С2-90С8 


%90С9-9005 


%9006-9103 


%9104-9124 


Function Е. Clear HIRES page to EOS 
using $927A. Then, cleartext page 
using monitor CLEOS. 


Function H. Backspace. Go left 
one character if entry at $902B. If . 
screen left, go up one line. 


Function |. Set inverse video flag 
by putting #$75 into $8E62. 


Function К. Set caps lock flag by 
putting #$00 into $8E66. 


Function L. Set lower-case flag by 
putting #$80 into $8E66. 


Unsupported function M. Apparently 
ascroll diagnostic, once reached by 
CTRL-S, CTRL-C. 


Function N. Setnormal video flag 
by putting #$00 into 8E62. 


Function O. Set option flag by 
putting #$40 into $8E60. Next key 
will complete option command. 


Option O. Pick overstrike mode by 
#$00 into 8E63 and #$00 into 8E64. 


Function P. Clear HIRES page via 
$9270 and text page via monitor 
HOME. Note that an image of the 
HIRES screen is puton text page 1. 


Option P. Pick print mode by 
putting #$00 into $8E63 and $8E64. 


Function Q. Home cursor inside 

text window. Move upper-left values 
to CH and CV. Then, reset text 
screen via monitor VTAB. 


Function R. Reverse overlay by putting 
#$С0 into $8E63 and $4 $60 into $8E64. 


Function S. Shift next character by 
putting #$C0 into flag $8Е66. 


Option S. Pick scroll mode by 
putting #400 into flag $8E65. 


Option T. Set transparent mode by putting 
#$80 into $8E63 and #560 into $8E64. 


Function V. Text window, upper left, 
by resetting WNDLFT and WNDTOP 
after check for on-screen values. 
Transfers vertical position to CV 

flag if not in block mode. 


Function W. Text window, lower right, 
by resetting WNDWDTH and WNDBTM 
after check for on-screen values. 
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Table 3-4 Cont. Complete Script of HRCG 


ADORESS COMMENTS 


$9125-912А Option W. Set wrap mode by putting 
#$FF into $8F65. 


$912B-914E Function Y. Open to full text 
screen by putting #$00 into WNDLFT 
and WNDTOP and #$28 into WNDWDTH 
and $#18 into WNDBOTM. Save as 
CH and CV flags if not block mode. 


5914Е-9151 Option Ү. Call user subroutine А 
by jumping to jump command stored 
at $8Е08. Defaults to RTS. 


$9152-9177 Function 2. Restore defaults. 
Resetall flags to #00. Set full 
text window. Pick default character 
set. Display primary page. Reset 
user subs to RTS. 


$9178-917А Option 2. Call user subroutine В 
by jumping to jump command stored 
at $8EOB. Defaults to RTS. 


$917B-9196 Begin character entry. Exit RTS if 
option flag set. Check case mode 
and change to upper case or reset 
shift flag if needed. 


$9197-91C4 Continue character entry. Calculate 
character location and save as $ЕЕ 
and ЕЕ. Calculate screen base 
address location and save as $EC and 
$ED. Thisisthetop dot row for any 
character position. The running dot 
row address gets held in $2A and $2B. 
Then, the character is saved on page 
One text screen. Like о... 


$28—29 - text screen base address 
$2A-2B - HIRES dot row address 
$EC—ED - HIRES base address 
$EE—EF - Character-set base address 


%91С5-91Ғ7 Continue character entry. Foreight 
dot rows, get the character dots and 
inverse if needed. Get the dots 
already on the screen; then, AND or OR 
with character dots if needed. Then, 
return resultto the screen. Next, 
calculate the address of the next 
lower dot row and repeat till all of 
the characters have been entered. 


$91F8—9220 Move cursor. Gooneto the right 
unless at extreme right of the window. 
На CR is needed, go down one line 
unless atextreme bottom of window. 
If at bottom, check flag for scroll 
or wraparound, and continue. 


$9219-9220 Wraparound mode. Set WNDTOP to top 
of text window. Do a monitor VTABZ 
to recalculate base addresses. 


$9221—926F Scrolling mode. Dot line source is 
%2А-%2В. Destination is address 
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Table 3-4 Cont. Complete Script of HRCG 


ADDRESS COMMENTS 


$ЕС-$ЕО. Destination is eight dots 
above source. Starting at the top 

of the screen, scroll downward, 
loading from ($2A) and storing at 
($EC). У register handles CH 
position, stepping from WNDWDTH 
downward. X register handles 
position of eight rows per character. 
One entire dot row is entered, then 
another until done. After a line is 
remapped, the base address of the 
nextline is calculated, making the 
old source the new destination, and 
calculating a new source. This 
continues until the entire screen is 
mapped. The bottom line is then 
cleared via $8E63. 


9270-9279 Clear screen. Set CV to WNDTOP 
and CH to WNDLFT and continue via 
$927E. 


$927A-928C Clear to end of screen. From 
present СН and СУ, clear to EOL 
via $9291 as often as needed to 
empty screen. 


$928D-92CA Clear to end of line. For eight 
dot rows, calculate address, then 
remove character from screen. 
Inverse background if needed. Y 
register works from CH to WNDWDTH 
doing one dot row ata time. X 
register handles dot rows, working 
from top of character down. 


$92CB-92DF Calculate HIRES base address. 
Divide CV by two. Go into the 
table in $92DF~92EA and lookup base 
address value. Process this value 
andstore in $2A and $2B. 


$92DF—92EA А stash of table lookup values used 
to calculate HIRES base addresses 
needed by $92CB or $92CD. 


$92EB—92FE Apparently unused garbage. 


$92FF—96FE Bulk file of default character set. 
Holds dot patterns of all ASCII 
Characters. The seven least 
significant bits hold the horizontal 
dot pattern IN REVERSE for one dot 
line. Eight successive bytes hold 
the dot pattern for one character, 
arranged from top to bottom. 
Locations $92FF—93FE hold numbers 
and symbols. $93FF—94FE hold 
upper-case alphabet, and $95FF—96FE 
hold lower-case alphabet. Bottom 
dot row is blank except for 
descenders. 96 characters total. 


If you are attacking a very complicated target program, chances аге the 
original author may have had some of the very same problems you did. And, 
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if he was smart enough, he just, possibly, may have built in some problem- 
solving diagnostics. 

For instance, the Adam adventures have a “Possible” and a “Did” tracing 
debugger that you can access with two keystrokes. Zork includes a hook that 
lets you stop the action after each code module, and print out whatever you like, 
such as the files just accessed. Zork will also give you a complete list of rooms 
with just a few keystrokes. A few minor changes to Wizard and the Princess and 
you get a guided tour of all the rooms. 

Be on the lookout for any diagnostic helps that may be built into the program. 
Then, see just how you can tap them. 

Breakpoints are another way to tackle a program. What you do is reach into 
the target program at a place where you want it to stop, and insert a $00 or BRK 
command. When the Apple reaches this point in the program, it will stop and 
immediately do a software interrupt. 

What happens next is decided by which monitor ROM you have in use. If you 
have the old ROM, the break puts you in the monitor and displays all of the 
working registers. If you have the autostart ROM, the BRK command does a 
jump indirect to the address contained in locations $03FO (low) and $03F1 
(high). You can go from this address into the monitor, or else, directly to another 
snoop program that spells out what each and every pointer and indirect address 
is up to. 

There is one clinker in the works when you use BRK. You might need the old 
ROM to gain control of the program so that you can change %03Ғ0 and $03F1, 
and then switch to the autostart one. A “protected” program under autostart will 
never let you get down into the monitor or change any locations. Use of either 
ROM card with a hardware change-over switch often can get you out of this 
bind. 

A breakpoint can be used as anything from a scalpel to a cannon, depending 
on what you want to do and how large a hole you want to blast in the target 
program. 

Drawing a flowchart may help you. | don't use that method too much since 
it sounds like something the dino people would want you to do. 

The addressing modes that give the 6502 microprocessor its extreme power 
are the indirect ones. These include jump indirect, indirect indexed, and the 
rarely used indexed indirect. All of these are identified by an address in paren- 
theses following the mnemonic. A lot of setting up is needed to use these 
locations. Most often, an address pair on page Zero has to be set up ahead of 
time. 

Understanding the rea/address used for an indirect instruction can be the key 
to cracking tough codes. It pays to spend lots of time being sure you know 
exactly where these addresses are going to and the reasons that they are doing 
so. 
Things really get interesting when you get involved in double and triple in- 
direct addressing, as is common in adventure programs. The code may go to 
some base address, pick an address pair out of a file there, and use that address 
as an indirect pointer in another instruction. If the files happen to be longer than 
256 bytes, then double indirect is needed, rather than a simple indexed instruc- 
tion. 

Patience and practice are essential to cracking indirect codes. If all else fails, 
replace the indirect op code with a BRK command. On the break, get into the 
monitor and check the locations used to hold the indirect address. 

Hooks are attachments you make to the program to gain partial control. You 
might write your own small “host” program and let it “borrow” subroutines off 
the target program. This is one possible way to dump files off protected disk 
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tracks. Once you are able to use and control key subroutines т the target 
program, you are well on your way to solving everything else. 

The tape cassette is often ignored. Yet the tape system is a very valuable tool. 
One “protection” scheme used involves putting a program in the same space 
where Apple DOS 3.3 would normally reside. A custom DOS is then put 
somewhere else and there is no immediate way to save the program entered 
under DOS 3.3, since booting the DOS 3.3 overwrites and, thus, destroys the 
program. 

But, the cassette doesn't care. It can save any code in any location at any time. 
One thing you can do is move the target code down in memory below DOS, 
save it to cassette, and then boot the DOS. Save this lower version on DOS and, 
then, add a “move” command that puts it back where it wants to sit. 

Cassettes are also useful in upgrading between various DOS versions. They 
are slow, unreliable, and unwieldy, but they just might work if all else fails. 

The single-step and trace features on the old monitor are very useful on some 
parts of some programs, particularly if you dump them to a printer. But watch 
out that you don't try to trace a delay loop, such as the one that waits for a disk 
drive motor to come up to speed. The trace operation slows things down some 
10,000 times from normal speed, so a two-second delay will take several days 
and miles of paper to print. Sometimes you can break into the loop, reset the 
counter locations, and continue. Other times, you'll have to combine single step 
or trace with breakpoints. Run the code till you hit the breakpoint, and then 
single step from there. 

Tracing to a printer is one very good way to crack indirect addresses to find 
the files that they work with. 

Beware of tracing parts of programs that read the screen, since tracing and 
displaying can interact. For instance, a clear-to-end-of-screen will hang during 
atrace, since trace keeps resetting the screen locations. If you are printing, defeat 
the screen echo during these times. 

Another custom attack method is to chip away at the target. Your goal may 
seem to be hopelessly buried in the middle of stuff that seems so complicated 
that it will take you forever to understand. If ali else fails, attack the easy stuff 
on the outside. Do this even if the easy stuff seems to have nothing at all to do 
with your goal. The parts of the code that outputs characters or inputs data are 
usually easy to read. Continue carving away on anything that looks like it might 
shake loose. What this indirect attack does is reduce the size of what is left to 
a point where you can hack at it directly. 

А big plus for the indirect attack is that it can show you the program author's 
style and where his head is at. Does he use self-modifying code? How does he 
handle multiple choice addresses? Does he use the indirect commands effective- 
ly and gracefully? Is he using mostly branches, or mostly jumps? How elegantly 
or how clumsily does he handle 16-bit addresses and long files? Does he exten- 
sively use the existing monitor, DOS, and BASIC subs, or is he reinventing the 
wheel? How clean is his organization? Is the program designed from the ground 
up for an Apple, or was it obviously modified from a program originally designed 
to run on some inferior machine? Answers to these questions can simplify very 
much the cracking of the rest of the code, since most decent programmers tend 
to be consistent in how they do things. 

If the code seems ridiculously obscure, attack the fundamental subroutines. 
These subroutines are the ones that won the popularity poll (the ones with all 
the dots). The subs to hit first are those that will not call any other subroutines, 
but will go ahead and do direct and obvious things. Common things that funda- 
mental subroutines will do include searching a long file for a value, calculating 
an address, or making a hex-to-decimal conversion. 
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Once you understand these fundamentali subroutines, you don’t have to go 
through them each time they crop up, since you know what they do. Create 
meaningful names for these fundamenta! subroutines and they will help you a 
lot in your attack. 

Asking for help is an obvious thing to do. There is nothing more infuriating than 
having an 8-year-old boy, just in from off the.street, make some casual comment 
that completely sums up what it just took you months to find out the hard way. 
So discuss the target program and its attack. Don’t only do it with "experts," 
but rap about it to anyone who will listen. Chances are their heads are in other 
places and might put things in a new light for you. 

The python force feeder takes some special hardware, but it can be very 
effective. A force feeder is some hardware and software modifications that 
include a super-powerful bus driver, say a 745245, or maybe three of them in 
parallel. When you tell it to do so, it substitutes its own code for what the 
computer is supposed to be working with. 

For instance, even the old monitor ROM can't help plowing part of the display 
page, the first few keybuffer locations, and part of page Zero when it is activated. 
A sneaky programmer can hide things in plowable locations. But not so with a 
force feeder. Besides being able to force a monitor reset any time you like, a 
force feeder can substitute anything at any place in the program. It can also 
move copies of plowable locations to unplowable ones for analysis. 

As a much simpler example of force feeding, consider the “top display line” 
copy protection hoax. What you do is switch to HIRES and, then, put a key jump 
or some other "magic" code that you want “hidden” on the top line of text 
display page One, starting at location $0400. This code is called early in the 
program and the program bombs if the code is not there. Naturally, the code 
gets erased immediately after use. 

This, in theory, makes any messing with the program impossible. Any tamper- 
ing at all will scroll up the display page and destroy the magic code. Sounds both 
bulletproof and infuriating. 

In reality, this is only a "seven-second" copy protection. What you do is force 
feed the Apple by making it display only text page One, and this “hidden” code 
actually leaps out at you, shouting to be heard. To force feed the page One 
display, remove integrated circuit F14 and ground pin No. 6 of the socket at F14. 
The hidden bytes will appear in Apple video-screen code, rather than op code, 
but if you got this far, that just adds to the fun. 

Similar force-feeding games can be played with most of the Apple soft switch- 
es that are needed for analysis or debug. 

Another handy debug trick is the partia/ boot. Instead of letting the target 
program completely boot, you.only let it go so far and, then, analyze what you 
have. This catches code modules before they are moved to cover DOS, and so 
on. For instance, the program, Роо/ 7.5, is generally considered to have excep- 
tionally good, or “three-hour,” copy protection. But, use a partial boot and the 
“three-hour” protection drops down to a much more convenient "'eighteen- 
minute" protection. More elegant "boot tracing can also be done. 

The trick here is to carefully watch the disk drive with the cover off and time 
out the different parts of the loading and protecting process. 

By the way, there's one sure-fire way to read any disk at any time. Just glomp 
a logic analyzer, with a 6502 personality module in it, onto the CPU and you 
are home free. Unfortunately, you can buy a dozen Apples for the price of one 
better grade logic analyzer, so this ultimate weapon does not see much use. 

Change detection is another interesting attack method. However, | haven't 
fully explored this one. What you do is dump part of memory, run a portion of 
the target program, and then see what changed. By finding out how, when, and 
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why that change took place, you сап often gain all sorts of insight into what is 
going on. 

Some day, | would like to build the ultimate change detector. This would take 
а DMA modification to the Apple that would let a second Apple or some type 
of dedicated hardware give you an instant and separate picture of memory 
activity while the main program was running. One display would show what the 
program was doing, while the second would show you each and every memory 
location of interest. Ideally, such a program should present any location or any 
block of locations that you want and would clearly identify them. With this 
ultimate change detector, you could actually watch the program while it was 
doing its thing. 

A variable-speed feature would also be nice here, so you could slow down 
or stop key activities without waiting forever for them to get through a delay loop 
or whatever. 

We've already seen how altering files can tell you lots of things in a hurry 
about your program. Sometimes you are shooting in the dark since some file 
locations may only rarely be used or might be used only in an obscure way. File 
changing is certainly worth a try. 

If you are going to change the target program or interact with it, it might pay 
to put the program on your own assembler and create your own source code. 
This lets you add your own hooks and make changes of your own choosing 
inside the target program. The EDASM on the DOS Toolkit is ideal for this. 
Assembling your own source code backwards from the object program is quite 
a hassle, though, and you shouldn't try it unless you have pretty much cracked 
everything else. Disassembler programs are also available that will "capture" 
code for your favorite assembler. 

Sitting on your program is often overlooked. Just walk away from the attack 
for hours or days, and things that should have been obvious all along will leap 
Out at you. Let your subconscious work on the puzzles that are holding you up. 

It works. 

Another thing that can help is to try attacking a similar program, either by the 
same author or by one that does the same thing in a simpler or easier-to- 
understand way. The insights you get from one program will help you attack the 
other program. 

Deciphering special codes may be needed in longer adventures. These codes 
are more often used to make code more compact than they are to purposely 
“hide” the meanings of what they hold. The trouble is that most compaction 
schemes used also do a most thorough job of masking everything that the file 
holds. 

For instance, in Zork, the ASCII strings are compacted so that two bytes hold 
three characters. Some newer adventures use paired letter or similar codes to 
remove the redundancy from text messages so that long text files will fit inside 
the machine. This is how the Co//ossia/ Cave adventure from Adventure Interna- 
tional manages to get everything that once demanded a mainframe dino into a 
48K Apple without needing repeated disk access. 

About the only way to attack these codes is to go into the code modules that 
decipher them. Then, decipher the decipheree. Single step, trace, or breakpoint 
access code modules till they show you how to read the file. Usually, there will 
be some obscure command or program feature that will do things a lot faster 
or simpler than the others. Trace this command or feature out and let it crack 
the code for you. 

The last resort, of course, is to give up. Go back and attack something that 
is simpler. 

My first machine-language attack of a major program was Adam's Pyramid 
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of Doom. This was done on a wilderness firetower using nothing but a 6502 poc- 
ket card. It literally took all summer, but it led to this attack method, and there is 
no better way to learn machine-language programming. 


CONVERGE ON YOUR GOAL 


Just as soon as you have the structure pretty well defined and as soon as you 
have cracked most of the code modules, return to your original goal and solve 
that particular problem. 

Our goal in HRCG was to find the scroll hooks. By now, they should leap out 
at you. 

Just as the cursor is about to go off screen at $9208, a check is made to see 
whether scrolling or wraparound is to be used. If scrolling is active, $9213 does 
a jump to the scroll subroutine starting at $9221. Specifically, $9214 will hold 
the /owaddress and $9215 will hold the high address of the scrolling subroutine. 

Just change these hooks enough so that you can use your own scrolling 
subroutine. 

Summing ир... 


The HRCG scroll hook is at $9214. 

$9215 holds the address low of 
the scroll subroutine. 

$9216 holds the address high of 


the scroll subroutine. 
The existing scroll subroutine starts 
at $9221 and ends with 
$926F. 


Easy, wasn't it? 
If not, go through a few practice target programs and see how fast and 
powerful this method can be. 


WRITE IT DOWN! 


Surely you don't want to go through all this a second time on the same target 
program. So, carefully write down everything you learned in some form that 
works for you. 

Make a clean copy of your analysis on the second listing you made. Also, 
make a neat new table of variables, a new cross-reference, and write a complete 
new script. Put most of this information onto disk so that you can have printable 
and updateable copies for later use. 

The insight that you.have now will be long forgotten in a month. Be sure that 
you will be able to later recover what you already have done, and will be able 
to do so both quickly and hassle free. 

Resist the urge to pull a “EUREKA! I have found it!” and run off with only your 
limited goal met. Do so, and the key information will disappear down the tube 
somewhere and all will be lost. 

The following outline sums up all the steps involved in tearing into machine- 
language code. Go back over them, and you'll find three parts to the attack. First 
you prepare yourself, then you attack the target program, letting it reveal itself 
through its form and structure. Finally, you follow up the attack to reach your 
goal. 
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Here is a quick summary of the tearing method. . . 


TEARING INTO 
MACHINE-LANGUAGE 


PREPARATION 


Assemble the toolkit. 

Grok the program. 
Co to the horse's whatever. 
Set a limited goal. 

Empty the machine. 

Find where the program sits. 
List and hex dump the program. 

ATTACK 

Separate action from bulk files. 
Paint subroutine returns green. 
Paint subroutine calls orange. 
P 
P 


( 
( 
( 
( 
( 
( 
( 


aint absolute jumps pink. 

aint relative branches blue. 

Separate modules and stashes. 
Identify files and stashes. 
Attack variables and constants. 
Paint housekeeping yellow. 


FOLLOW UP 


() 
() 
() 
() 
() 
() 
() 
() 
() 


Make а list of variables. 
Write a script. 
Customize the attack. 
Converge on your goal. 
WRITE IT DOWN! 


Practice makes perfect. Try ite 
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WILL THE REAL LISTING PLEASE JUMP OUT? 


There are times when the disassembler in the Apple monitor lies like a rug. 


A disassembler always assumes it is working with valid op codes. It starts with the first code 
byte it finds and, then, decides what operation the Apple is to do. Depending on the particular 
op code, one, two, or three bytes will be needed to complete the operation. 

For instance, the CLC or clear carry command is an implied addressing instruction handled 
with a single byte. No further information is needed. The LDX #05 immediate command takes 
two bytes, one to tell you what to do and one to answer “How much?” The STA $4050 com- 
mand uses absolute addressing and takes three bytes, one to (ей us what to do and two bytes to 
answer “Where?” by giving us address low and, then, address high values. 

Thus, a disassembler will automatically jump one, two, or three bytes to get to the start of the 
new instruction. The disassembler always assumes it is working with valid code from a legal 
starting point. 

If either the starting point is wrong or if what is being disassembled is not legal code, the "lis- 
ter” starts lying. 

Suppose we have these bytes stashed in memory . . . 


$0800- 80 8D AD 02 А5 18 ЕА 
Here is what you get if you try to disassemble this code from various starting points. . . . 


$0800- 80 $ 

$0801- 8D AD 02 STA $02AD 
$0804- AS 18 STA $18 
$0806- EA NOP 


$0801- 8D AD 02 STA $02AD 
$0804- AS 18 STA $18 
$0806- EA NOP 


$0802- AD 02 A5 LDA $A502 
$0805- 18 CLC 
$0806- EA NOP 


$0803- 02 % 
$0804- А5 18 5ТА 518 
$0806- ЕА МОР 


We see that we get a different disassembly every time, depending on where we start from. 
Which one is correct? 

The correct disassembly is the one that begins with the first valid op code on the list. The first 
valid op code is often pointed to elsewhere in the program by a jump, a branch, a subroutine 
call, or an external entry point. 

You can expect the “lister” to lie about one-half of the time when it comes out of a file or dead 
code and starts into legal code. 

Usually the "lister" will correct itself after two or three wrong entries. So, you usually only 
have to worry about the first few entries into valid code. 

If what you have just listed seems dumb, try listing from one above or one below where you 
think the legal code starts. Most of the time, there will only be one rational and sensible starting 
place and the valid code will leap out at you. 


But remember that the "lister" will only tell the truth when it has both true code and а true 
starting point to work with. 


Enhancement 


FIELD SYNC 


A one-wire hardware modification 
that makes for stunning new ani- 
mation and graphics action ef- 
fects. Now, you can exactly lock to 
video timing for split screens, 
high-accuracy light pens, and 
much more. 


FIELD SYNC 


This enhancement is so horrendously powerful that it’s scary. 

It is a one-wire plug-in modification to your Apple that gives you field sync 
and opens up so many mind-blowing new possibilities that we can’t even begin 
to hint at them here. What field sync does is lock your display to your program. 
You can now flip soft switches, update display screens, or change pages while 
the screen is on its vertical blanking return trip. You can also keep ahead of or 
behind the live scan lines to keep your display from mixing "old" and “new” 
stuff at the same instant. 

And, we will show you a brand new and incredibly powerful software method 
to lock to your video field timing that is exact to a fraction of a microsecond. 
This exact sync lets you mix and match display modes, both dynamically and 
“on the fly” for splits or wipes in any direction. Exact sync also can eliminate 
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90% of the parts and the hassle needed for а fast and precision light реп or for 
a touch screen. 

So, what else is field sync good for? 

For openers, gone forever are any glitches, flashes, and garbage that whip by 
at any time that you change an Apple screen mode. Field sync is the key to 
smooth, glitch-free animation without any collision or dropout effects. Here is 
the path to smooth-moving gentle scrolls that let you read things as they move 
up the screen. Here, also, are spinners and other action animation made totally 
continuous and smooth acting. 

Want 3-D graphics? Want lots of different single-line colors in HIRES that cross 
and overlap in any combination? Want to mix LORES and HIRES? Or, want to 
mix and match text and LORES all over the screen? Or, all three? How about 
a mixed graphics mode with the text at the top? Or, in the middle? Or, graphs 
with quickly changed labels in both the X and Y direction? 

Are you into animation? Field sync lets you compute and display at the same 
time on the same page without any glitches, dropouts, sugar, or other hassles. 

What about some video wipes that smoothly move one page off the screen 
to reveal a second hidden page, done in any direction, at any speed, in any 
combination? Or, a choice of hundreds of LORES colors? How about a bomber 
flyby or a road race, smooth, fast, and alias-free? 

Need some grey scale? Sure thing. How about some game symbols that mix 
a pair of ordinary text characters into a single symbol? Text over color? Naturally. 

Maybe you would like a full color HIRES adventure where the text optionally 
“floats” in front of the graphics display. This is trivial with field sync. 

All these only scratch the surface. We haven't even begun. And, it's real 
spooky to even think about what will happen when a really good programmer 
gets his hands on this mod. 

And, best of all, it is back to the drawing board for you Atari people. Apple 
wins this round of "Whose-got-the-best-color-graphics?" bytes down. 

In this enhancement, we will look at what a field sync modification is and how 
you can make one. We will also give you some very simple yet powerful support 
software. We'll then spend much of the rest of the book exploring a few of the 
more blatantly obvious uses of field sync. 

Total cost of the enhancement is around $2.00 and can be done in a few 
minutes. The modification will not void your Apple warranty and is completely 
removable. The support software, even that needed for an exact lock, takes only 
a few machine-language bytes and is easily reached from any language. 


WHY SYNCHRONIZE? 


Every personal computer designer faces the dilemma of how to compute and 
display video at the same time. The timing and video signals sent to your monitor 
or color tv are extremely critical and must be there all the time. Even the briefest 
mixup or delay, and you end up with a twisted, torn, or missing picture. 

Apple solved this dilemma in a brilliant way. Check into the 6502 micro- 
processor timing and its memory-access activities, and you find out that the CPU 
only accesses memory on one half of each of its clock cycles. The Apple's clock 
Cycle is slightly under one microsecond. Of this time, the 6502 microprocessor 
used as the Apple's CPU must have unrestricted memory access for only half 
of each microsecond. 

On the other half of each clock cycle, the 6502 CPU and the rest of the 
Apple's computing circuitry couldn't care less what the main RAM memory was 
up to. 
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So, an elaborate hardware circuit called a multiplexer was set up that gives 
memory access to the Apple's computing circuitry for one half the time and gives 
the Apple's video-display circuitry memory access for the other half. Each is 
happy with its half of the access, and each piece of circuitry gets its access each 
and every microsecond. 

The result is glitch-free and flicker-free video that is totally independent of any 
computing activity. Most importantly, this is done using the main memory rather 
than a separate video display memory. This means that no time or effort is 
needed to get between a result and putting that result on the screen. No wait 
for video memory access is ever needed. Nor is any time ever taken away from 
the critical video display waveforms. The operation is fully transparent and 
totally invisible. 

Both the thinking and the design that went into the Apple's video timing 
circuitry was brilliant; it is a totally independent video that is immediately acces- 
sible to all. 

But, they overdid it. 

The video display timing is completely independent from the computing 
timing, although both are derived from common signals. This means that there 
is no immediate way for the computing circuitry to tell where the video-display 
circuitry happens to be in its timing cycle. 

Field sync gets around this total independence by taking a sample waveform 
from the video display timing and routing it back into a location where you can 
test it with software. We will use part of the cassette read circuitry as an input 
to feed back this timing signal for us. 

Let's take a closer look at the Apple's video timing and see if we can't find 
a good waveform to give us field sync. 


Timing waveforms 


A simplified block diagram of the Apple's timing chain is shown in Fig. 4-1. 
There are three main parts to this chain. These are the video rate timing, the 
horizontal rate timing, and the vertical ог field rate timing. 

The video-rate timing is the fastest. It starts with a 14.318-megahertz crystal 
oscillator that is the master timing reference for everything in your Apple. This 
master reference is divided by four to get the standard color subcarrier frequen- 
cy of 3.579 megahertz. The master reference is further divided by 3-1/2 to get 
a CPU clock frequency of 1.023 megahertz. 

This CPU clock frequency also sets one horizontal character time on the 
screen. The horizontal character time is equal to seven video dots. In HIRES, 
these seven dots equal the least significant seven bits in the data word, arranged 
backwards. In standard text, these seven dots consist of two blank undots and 
five horizontal dots from the output of a dot matrix character generator. The 
character generator receives the bits in the data word and then converts them 
to the proper dot patterns for you. 

Either way, seven dots go on the screen in one CPU clock cycle. These seven 
dots equal three and one-half color clock cycles of 3.58 megahertz each. The 
color of the dot will be decided by the position or the time delay of the dot with 
respect to the phase of the color-reference signal. 

The video rate timing does several other things for us. The two clock phases 
needed by the CPU are split out with this timing. The video timing automatically 
gets the seven dots lined up in the right place in the right time for us. And it 
automatically takes care of the multiplexing needed so that the memory can be 
shared between the display and the CPU. This memory multiplexing is more 
complicated than it would seem at first since the memory chips used make each 
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MASTER CRYSTAL 
14.318 MHz 


DOT RATE = 7.158 MHz 


VIDEO 
TIMING 
COLOR RATE = 3.579 MHz 
CHARACTER RATE _ 
AND CPU CLOCK + 1023 MHz 
HORIZONTAL 
TIMING 
H LINE RATE = 15,698 Hz 
VERTICAL 
TIMING 


V FIELD RATE = 59.92 Hz 


Fig. 4-1. Details of Apple's timing chain. 


RAM address pin do double duty. Thus, the multiplexer has to go through four 
steps each clock cycle and not just two. 

The CPU clock frequency of 1.023 megahertz is the lowest frequency needed 
by the computing side of the Apple. All of the rest of the timing chain is mainly 
involved in video display timing. Outside of their sharing the same high-frequen- 
су timing, the computing side and the display side of the Apple are more or less 
independent. 

The horizontal rate timing sets the line length and the horizontal sync rate for 
us. There are 65 possible character positions in a horizontal line. Of these, 40 
are “live” video slots and 25 are “blank” video slots. A live video slot can hold 
seven HIRES dots, a horizontal portion of a 5 x 7 dot matrix character, or a 
color pattern needed as part of a LORES color block. 

Fig. 4-2 shows us the waveform of a single horizontal line. We start with the 
blank character positions. Into these blank character positions, we put a “blacker 


— NE H ИМЕ 
65-1/7 CPU CLOCKS ——s 


арашашы CPU CLOCKS 


H SYNC "X COLOR LIVE VIDEO, 
PULSE BURST 40 CHARACTERS 
OR 280 DOTS 


Fig. 4-2. Horizontal rate timing display is black or off screen except for live video time. 
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than black” horizontal sync pulse, followed Бу a reference burst of a number 
of 3.58-megahertz color-reference cycles. The exact number and position of 
these reference cycles depend on the version of your Apple. Some older Apples 
would not give you color on certain video recorders or on a few oddball brands 
of premium tv sets. The Revision 7 upgrade seems to have eased this. 

After the horizontal sync pulse and the color burst, we have some more blank 
character locations. These are followed by the 40 live characters per line. 

There is one tiny but crucial detail added in the horizontal timing. The line is 
an odd number of CPU clock cycles in length. Each clock cycle equals 3.5 color 
cycles, which means that when you get to the start of the next line, the color 
reference will be half a cycle off. To get around this, the video timing is delayed 
by half a color clock cycle once each horizontal line. Thus, every sixty-fifth CPU 
clock cycle will be wider by half a color cycle, or around 140 nanoseconds 
wider than usual. 

This handles a key difference between commercial color-tv broadcasts and 
Apple signals nicely. In commercial color tv, you want the color subcarrier to 
cancel each successive horizontal line so that the subcarrier doesn't interfere 
with the luminance video. In the Apple, though, the subcarrier /s the video, so 
you want its phase to be the same on each line. If you didn't do this, a green 
dot on one line would be a violet one immediately below, and so on. 

At any rate, our horizontal line consists of 25 blank locations followed by 40 
live locations. One of these blank locations is slightly wider than the others to 
keep the colors in step. Our horizontal sync frequency ends up at 15,698 hertz. 
This compares with the 15,735 hertz of a color commercial tv broadcast or the 
15,750 hertz used юг black and white commercial tv broadcasts. 

The horizontal-rate timing also is used to refresh the dynamic RAMs. The 
timing is arranged to exercise the RAMs in such a way that they continue to hold 
valid data for us. This refresh is invisible and "free" since it automatically takes 
place as part of the normal display timing. 

The vertical-rate timing takes the horizontal timing and divides it down by a 
factor of 262, giving us the vertical waveforms shown in Fig. 4-3. There are 192 
live lines and 70 blank lines. The 192 live lines are sequentially scanned in 
HIRES. In LORES, the 192 lines are clustered into 48 groups of 4 lines each, one 
for each LORES block on the screen. In TEXT, the 192 lines are arranged into 
24 groups of 8 lines each, one for each of the possible vertical dot positions 
needed in a 5 Х 7 plus blank dot matrix character. 

A vertical sync pulse is provided in the middle of the vertical blanking time. 
This vertical sync pulse is much wider than a horizontal sync pulse. This lets the 
tv separate its vertical sync locking command from its horizontal sync locking 
commands. 


— ONE V FIELD 


—— 1060: LINES 
~— 70 H LINES -->-<- 192 H (ІМЕ5-----> 


—— WRITE 


BLACK 


SYNC 


м SYNC H SYNC LIVE VIDEO, 
PULSE PULSES 192 H LINES 


Fig. 4-3. Vertical-rate timing waveforms. Any mapping or soft switching done during 
blanking or retrace will be invisible. 
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Since there аге 65 CPU clock cycles рег line and 262 lines total, there аге 
apparently 65 * 262 = 17,030 clock cycles per field. The field frequency is 
59.92 hertz. This compares with the 60 hertz of a black and white commercial 
broadcast or the 59.94-hertz vertical rate of a color broadcast. 

Let's sum up some of these magic numbers . . . 


APPLE SYSTEM CONSTANTS | 


Тһе CPU clock frequency is 1.023 
megahertz and has a time width of 
0.978 microsecond. Every sixty-fifth 
clock pulse is slightly longer. 


A horizontal line takes 65 CPU clock 
cycles and consists of 25 blank and 
40 live cells. Each cell holds seven 
HIRES dots or one row of dots from a 
dot matrix character. 


Horizontal frequency is 15,698 hertz. 


A vertical field takes 262 horizontal 
lines and consists of 70 blank and 
192 live scans. Live scans are used by 
eights for text, by fours for LORES, 
and by ones for HIRES. 


Field frequency is 59.92 hertz. 


There are 17,030 CPU cycles per 
field. 


The timing waveform we want for field sync will have a rising edge at the 
beginning of the vertical blanking time and a falling edge at the start of the next 
field. If we look at the timing waveforms immediately off the timing chain, we 
see that this waveform is not available. Waveform V5 could be used, but it is 
only six horizontal lines wide, and, also, it is backwards from what we really 
want. 

Instead, there is a vertical blanking waveform derived by an лмо gate in B11. 
The magic signal outputs on pin 8 of B11. (See the Apple board parts locations 
sidebar at the end of Enhancement 2 for details on the Apple’s parts locations.) 
Мече shown this waveform in Fig. 4-4. 

This particular integrated circuit is pretty much buried under the keyboard. 
Check the schematic, though, and we find its output goes to pin 4 of C14. This 
point is much easier to reach. 


GOES ТО A "1" AT GOES TO A "0" AT 
BOTTOM OF SCREEN TOP OF SCREEN 


w . -XƏ—— 
BLANK AND LIVE VIDEO 
RETRACE 


Fig. 4-4. Vertical blanking waveform used for field sync appears on pin 4 of С14. 
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Fig. 4-5 shows us the "schematic" of the field sync modification. We connect 
the vertical blanking waveform to a point in the cassette receiver circuitry that 
sometimes sees use as a "phantom" fourth pushbutton input. Electrically, this 
means that we jumper pin 4 on C14 to pin 4 on H14. 


Fig. 4-5. "Schematic" of the field sync VBNK ом 
modification. One wire does И. 41С14 


Ош vertical blanking waveform is low for the 192 live scan lines and high for 
the 70 blank scan lines used for vertical retrace. If we can find the leading edge 
of this waveform with some simple software, we will have the entire blanking 
time to do things to the screen that will not show up till the next field. Also, if 
we can find the trailing edge, we can find out exactly when the next field will 
begin. 

Many of the uses of field sync are just to simply flip a soft switch or two at 
any old time during the vertical blanking interval. Other uses may want to use 
every available microsecond of the vertical blanking time to remap an animated 
sequence. Yet others will need to find the exact start of a field for mixed field 
displays, or for use with either a precision light pen or a touch screen. 


Building it 


The field sync modification consists of a pair of sockets with a jumper wire 
between them. The mod plugs into the Apple main board. You can easily 
remove the modification later if the unit must be sent in for warranty repairs or 
whatever. 

The modification also has to be removed if you use the cassette playback 
circuitry or if you use an external game paddle add-on that needs a "fourth" 
push-button input SW3. 

These are the parts you will need . . . 


PARTS LIST FOR 
FIELD SYNC MODIFICATION 


1 — 16-contact quality 
DIP socket, 
machined-pin style. 


1 — 14-contact quality 


DIP socket, 
machined-pin style. 


1 — piece of No. 24 solid 
wire, insulated, 
7-1/2 inches long. 


1 — short piece of 
electronic solder. 
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And, here are the tools you will need . . . 


TOOLS NEEDED TO MAKE THE 
FIELD SYNC MODIFICATION 


( ) Needle nose pliers 


( ) Wire stripper 
( ) Small soldering iron, 35 watt 


( ) IC puller (optional) 


( ) Any old 14- or 16-pin 
integrated circuit 


( ) Small vise or clamp 


Fig. 4-6 gives us the complete construction details. Be absolutely sure to use 
high-quality machined-pin style DIP sockets here, since these are the only kind 
that can easily and safely be plugged into another DIP socket. 

The “dummy” integrated circuit you plugged into the socket helps prevent the 
plastic from melting and keeps the pins aligned but you still have to be careful. 
When soldering to these sockets, be sure to prevent any shorts between adjacent 
pins 3 and 5, and be careful not to heat soften and distort either socket. 

A pictorial of the field sync modification is shown in Fig. 4-7. If you 
decide to make your sync mod more or less permanent, you may want 
to tack the wire to the board with hot glue, silicon rubber, or some other 
“semi-permanent” gunk. Be careful not to get any glop оп the socket pins. 

Should you ever want to remove your field sync modification, just reverse the 
process that is shown. While this modification does, in fact, void your Apple 
warranty, if you are very careful not to bend any pins or get any ICs mixed up, 
you should be able to remove any signs that the modification was ever 
in use. 


SUPPORT SOFTWARE 


Interpreted Applesoft is far too clumsy and way too slow to directly use field 
sync. You'll find field sync is best handled by short and fast machine-lan- 
guage subroutines. These subroutines can be called from any language you 
like. 

Program 4-1 gives us six simple field sync utility subs, while Program 4-2 is an 
Applesoft routine that will test your field-switch modification for you and give 
you an alternating text and HIRES display. 

The field-switch modification routes a copy of the vertical blanking waveform 
of Fig. 4-4 into the cassette circuitry at “5У/3.” SW3 is software tested in 
location hex $С060. When you are in the //ve portion of the scan, a zero ог low 
level gets routed to the most significant bit of $C060, and a test of this location 
will show a positive number in 2's complement signed binary. When you are 
in Ше blank portion of the scan, a one or high level gets routed to the most 
significant bit of $С060, and a test of this location will show a negative number 
here, again in 2’s complement signed binary. 
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N 
7 402" INSTRUCTIONS FOR BUILDING 
m FIELD SYNC MODIFICATION 
<< 14" 

=й 1. Cut a piece of insulated No. 24 solid wire to a length of 71/2 
inches. Then strip % inch insulation off each end. 
Form a tight loop in each end as shown. 

= ВИРА ENDS 2. Take a 16-pin machined-contact DIP socket and identify pin 


No. 4 by inking the plastic. Plug any old nonvaluable in- 
tegrated circuit you have on hand into this socket. This will 
keep the pins aligned should the plastic soften. Secure this 
Socket in a vise so you can work with it. 


S ša a SUNT MS 
вопъок-се 


Note that this MUST Бе the type of premium socket that has 
small machined-pin contacts that are safe to plug into another 
socket. 


3. Solder one end of the 712 -іпсһ wire to pin No. 4 of the 16-pin 
DIP socket EXACTLY as shown. Be careful not to melt the 
plastic. 


Be sure that no solder gets on the part of the pin that must fit 
into socket H14 on the Apples main board and be sure that 
there is no short to adjacent pins 3 and 5. 


4. Take the 14-pin machined-contact DIP socket and identify 
pin No. 4 by inking the plastic. Move the nonvaluable in- 
tegrated circuit into this socket. 


Secure this socket in a vise just like you did the earlier one. 


5. Solder the remaining end of the 72-inch wire to pin No. 4 of 
the 14-pin DIP socket EXACTLY as shown. 


Again, be careful not to melt plastic, get solder on the pin, or 
short adjacent pins. 


6. Arrange the field sync modification as shown. Note that the 
wire goes past pin No. 1 on the 16-pin DIP socket and past pin 
No. 7 on the 14-pin DIP socket. 


16 PIN 


о 


9999909) 


7. И you want to, add a dab of silicon rubber, epoxy, or other 
glop to the wire where it leaves each socket body. This will act 
as a strain relief and keep the wire from breaking. 


[999939 


S 


és 


Remove the integrated circuit to complete your field sync 
modification. Put this ІС away and out of sight. Refer to text for 
installation and checkout. 


Fig. 4-6. How to build the field sync modification. 
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Неге is how you install your field sync modification. 


INSTALLING YOUR 
FIELD SYNC MODIFICATION 


. Turn off the Apple and unplug 
both ends of the line cord. 


. Verify that no other use is being 
made of the cassette read circuitry, 
such as a “fourth” push button 
SW3 add-on. 


. Remove integrated circuit C14, a 
741532, using an IC puller if you 
have one. 


. Plug the 14-pin end of your field 
sync mod into C14. Make sure the 
wire is to the right and the notch is 


pointing towards the keyboard. 


. Plug the 741532 into Ше 14-pin 
socket now at C14. BE SURE 
NOTCH POINTS TO KEYBOARD! 


. Remove integrated circuit H14, a 
7415151 ог 7415251, using an IC 
puller, if you have one. 


. Plug the 16-pin DIP end of the 
field sync mod into H14. Be sure 
that the wire goes to the right and 
the notch points towards the 
keyboard. 

. Plug the 74LS151 or 74LS251 into 
the 16-pin socket now at H14. BE 


SURE NOTCH POINTS TO 
KEYBOARD! 


A machine-language command called a BIT test will automatically transfer the 
MSB of $С060 into the М flag for you, allowing easy branching. The only 
confusing part is that the b/ank time gives you a positive voltage and а 1 to the 
game connector which, in turn, is read as a negative number. The /ivescan time 
gives you a zero voltage and a 0 to the game connector which, in turn, is reaa 
аз а positive number. This oddball turn of things is caused by the 2's complement 
signed binary used by the 6502's branch testing. 

Anyway... 


Your field sync is tested at location 
$C060 by the command BIT 
$C060, or “2C 60 СО”. 


This test CLEARS the N flag during 
live scan times and SETS the N flag 
during vertical blanking times. 
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Й GAME PADDLE 
CONNECTOR 


(1) ADAPTER MADE FROM 
PREMIUM 16-PIN DIP 
SOCKET GOES IN H14. 


74LS251 PLUGS INTO 
ADAPTER. 


(3) JUMPER WIRE 
CONNECTS PIN 4/C14 


TO PIN 4/H14 
Fig. 4-7. Pictorial shows field sync 
modification. TACK WITH 
HOT GLUE 
(OPTIONAL) 


@ADAPTER MADE FROM 
PREMIUM 14-PIN 

DIP SOCKET GOES 

IN C14. 


(B) EXISTING 741532 
REPLUGS INTO 
ADAPTER. 


# 


In Program 4-1, we will show you six simple ways to use your field sync. 
These are shown as program modules 1 through 6. These short machine-lan- 
guage modules are all separately located on memory page $03. You can easily 
relocate them in any protected place in your machine that you want. 

Examples of protected space in your Apple are the lower part of page 3 (when 
available), any locations set aside below LOMEM in Integer BASIC, any locations 
set aside above HIMEM in Applesoft, or one of the slots intended for optional 
character set that are used in HRCG. 

For simplicity, we will show all the examples starting at separate locations on 
page $03. You can relocate these modules anywhere that they won't get plowed 
by something else. 

Our first subroutine is the simplest, being all of six bytes long. It is called 
CRUDE and is just that. We enter this subroutine whenever we want to find the 
vertical blanking time. If we are in the vertical blanking time already, the BIT test 
will immediately give us a set N flag, and the BPL branch test will immediately 
fail, giving us a fast return. If we are in the live scan time, the BIT test will clear 
the N flag, and the branch will then try again. We keep trying, once each seven 
CPU cycles, till we finally reach the blanking time. Then we exit. 

With this sub, you can always be sure you will return sometime during the 
vertical blanking interval. But, notice that you must not try recalling CRUDE 
more than once per field. If you have a fast machine-language program, calling 
CRUDE could return several times in the same field and really foul things up. 

The big disadvantage of CRUDE is that you never know exactly how much 
time you have available before the next scan begins. Three times out of four, 
you will have the full blanking time. But every now and then, you will catch the 
blanking at the last possible instant. This only leaves you with a dozen or so 
useful microseconds before the next live scan starts. 

For instance, say you happen to sample on the very last CPU clock cycle of 
the blank portion of the field. Two more CPU clock cycles will be taken up by 
the branch test, which fails, and six more CPU clock cycles will be needed for 
the RTS. This actually puts you into the first live scan line by 7 CPU clock cycles. 
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PROGRAM 4-1 
FIELD SYNC UTILITY SUBS 


LANGUAGE: APPLE ASSEMBLY NEEDS: FIELD SYNC MOD 


Yk * * k * *  * k k k k k k k k? k k k k Я 


0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 
0300: 


FIELD SYNC 
UTILITY SUBS 
($300.392) 


VERSION 1.0 
( 7-15-81) 


COPYRIGHT 1981 
BY DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


Me Me ме se Se Sa че ча ча че че Se ~e че че ме ча 
ЖЖ + HF FH ЛЕ ЛЕ ЛЕ ЛЕ ЛЕ * 
t+ +f * + + + +e +e и жи # * 


kkkkkkkkkkkkkkkkkkk 


0300: 
0300: 
0300: 
0300: 
0300: 


THESE SIX MACHINE LANGUAGE 
MODULES ACCESS THE FIELD SYNC 
MODIFICATION DESCRIBED IN 
ENHANCEMENT #4 OF ENHANCING 
YOUR APPLE, VOLUME I. 


< 99 99 se se 


MODULES MAY BE RELOCATED IN 
ANY PROTECTED SPACE. 


DELAY EQU 
GRAPHIC EQU 
KEYBD EQU 
SYNC EQU 
TEXT EQU 


MONITOR DELAY SUB 
GRAPHICS SCREEN SWITCH 
KEY PRESS CHECK 
VBLANK УТА "Sw3" 

TEXT SCREEN SWITCH 


Э x 98 x? ~e 


PROGRAM 4-1, CONT’D... 


0300: 


0300: 
0300: 


0300: 


0300: 


0300: 
0300: 


0300:2С 60 CO 
0303:10 FB 
0305:60 


Field Sync 


MODULE #1 -- "CRUDE" -- 


THIS MODULE RETURNS SOMETIME DURING 
THE VERTICAL BLANKING INTERVAL. 


TO USE, JSR $0300 FROM MACHINE LANGUAGE 
DO NOT USE MORE THAN ONCE PER FIELD! 


THIS MODULE MAY BE USED EVERY FIELD. 
IT WILL HANG IF FS MOD.IS ABSENT. 


CRUDE BIT SYNC LOOK FOR BLANKING 
BPL CRUDE AND REPEAT TILL FOUND 
RTS THEN EXIT 
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PROGRAM 4-1, CONT'D... 


0310: ORG CRUDE+$10 


MODULE $2 -- "FEDGE" -- 


THIS MODULE RETURNS AT START 
OF NEW FIELD WITH SLIGHT JITTER. 


TO USE, JSR $0310 FROM MACHINE LANGUAGE 


THIS MODULE MAY BE USED EVERY FIELD. 
IT WILL HANG IF FS MOD IS ABSENT. 


0310:2C LOOK FOR LIVE SCAN 
0313:10 AND RETRY TILL BLANK 
0315:2C LOOK FOR BLANKING 


0318:30 AND RETRY TILL LIVE 
031A:60 THEN EXIT 
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PROGRAM 4-1, CONT’D... 


0320: ORG CRUDE+$20 


MODULE #3 -- "BEDGE" 


THIS MODULE RETURNS AT START 
OF VBLANK TIME WITH SLIGHT JITTER. 


TO USE, JSR $0320 FROM MACHINE LANGUAGE 


THIS MODULE MAY BE USED EVERY FIELD. 
IT WILL HANG IF FS MOD IS ABSENT. 


0320:2C 60 CO LOOK FOR BLANK 

0323:30 FB AND REPEAT TILL LIVE 
0325:2C 60 CO LOOK FOR LIVE SCAN 
0328:10 FB AND REPEAT TILL BLANK 
032A:60 THEN EXIT 
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PROGRAM 4-1, CONT'D... 


0330: ORG CRUDE+$30 


MODULE #4 -- "ALTFLD" -- 


THIS MODULE ALTERNATES BETWEEN 
TEXT AND GRAPHICS FIELDS. IT 
EXITS ON ANY KEY PRESSED. 


TO USE, JSR $0330 FROM MACHINE LANGUAGE 
OR CALL 816 FROM EITHER BASIC 


THIS MODULE DISPLAYS CONTINUOUSLY 
TILL ANY KEY IS PRESSED. 


IT WILL HANG IF FS MOD IS ABSENT. 


0330:20 10 FEDGE 
0333:8D 50 GRAPHIC 
0336:20 10 FEDGE 
0339:8D 51 | ТЕХТ 
033C:2C 00 КЕУВО 
033Е:10 ЕЕ ALTFLD 
0341:60 


FIND FIELD START 
SWITCH GRAPHICS ON 
FIND FIELD START 
SWITCH TEXT ON 

HAS KEY BEEN PRESSED? 
CONTINUE IF NO KEY 
EXIT ON KEYDOWN 


че 99 чо ме ча 9» ne 


Field Sync 105 


PROGRAM 4-1, CONT’D... 


0350: 118 ORG CRUDE+S$50 


MODULE #5 -- “EXACTF" -- 


THIS MODULE EXITS EXACTLY SEVEN 
MICROSECONDS INTO THE START OF A 
NEW FIELD WITH ZERO JITTER. 


UP TO SEVEN FIELDS MAY BE 
NEEDED TO ACQUIRE EXACT LOCK. 


TO USE, JSR $0340 FROM MACHINE LANGUAGE 


ONCE LOCKED, MAIN PROGRAM MUST 
CONTINUINE LOCK TILL DONE. 


THIS MODULE MAY NOT BE USED EACH FIELD. 
IT WILL HANG IF FS MOD IS ABSENT. 


0350:2С ЕХАСТЕ BIT SYNC 
0353:10 ЕХАСТЕ 
0355: 2С BLENK SYNC 
0358:30 BLENK 
ОЗ5А:ЕА 

0358:10 STALL 
035D:A9 $$3B 
035F:20 DELAY 
0362:A9 #$34 
0364:20 DELAY 
0367:A9 #501 
0369: 20 DELAY 
036C:2C SYNC 
036F:10 STALL 
0371:60 


FIND BLANKING TIME 


FIND FIELD START 
WITH JITTER 

STALL FOR 2 CYCLES 

STALL FOR 3 CYCLES 

DELAY FOR 17029 
CLOCK CYCLES TOTAL 
USING THE MONITOR 
DELAY ROUTINE AND 
THIS LOOP TIMING. 


HAVE WE BACKED TO START? 
NO, GO BACK ONE MORE 
EXIT ON EXACT LOCK 


"e ча ча ne ~e че че че зэ че че че ча че ме 


706 Enhancement 4 


PROGRAM 4-1, CONT’D... 


0380: 154 ORG CRUDE+$80 


MODULE #6 -- "ЕХАСТВ" -- 


THIS MODULE EXITS EXACTLY SEVEN 
MICROSECONDS INTO THE BLANKING OF A 
NEW FIELD WITH ZERO JITTER. 


UP TO SEVEN FIELDS MAY BE 
NEEDED TO ACQUIRE EXACT LOCK. 


TO USE, JSR $0370 FROM MACHINE LANGUAGE 


ONCE LOCKED, MAIN PROGRAM MUST 
CONTINUINE LOCK TILL DONE. 


THIS MODULE MAY NOT BE USED EACH FIELD. 
IT WILL HANG IF FS MOD IS ABSENT. 


0380:2С 173 EXACTB BIT SYNC 
0383:30 174 EXACTB 
0385:2C 175 BLUNK SYNC 
0388:10 176 BLUNK 
ОЗ8А:ЕА 177 

0388:30 178 STAUL 
038D:A9 179 #$3B 
038F: 20 180 DELAY 
0392:A9 181 #$34 
0394:20 182 DELAY 
0397:A9 183 #$01 
0399:20 184 DELAY 
039С:2С 185 SYNC 
039Ғ:10 186 STAUL 
03A1:60 187 RTS 


FIND LIVE SCAN TIME 


FIND BLANKING START 
WITH JITTER 

STALL FOR 2 CYCLES 

STALL FOR 3 CYCLES 

DELAY FOR 17029 
CLOCK CYCLES TOTAL 
USING THE MONITOR 
DELAY ROUTINE AND 
THIS LOOP TIMING. 


HAVE WE BACKED TO START? 
NO, GO BACK ONE MORE 
EXIT ON EXACT LOCK 


se 99 <. че ~o “0 99 99 9 9 99 че че ча че 


*** SUCCESSFUL ASSEMBLY: МО ERRORS 
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But, each live scan line starts off with its 25 blank CPU clock cycles used for 
horizontal retrace, sync, and the color burst. The net time we have left is only 
25—7 = 18 CPU clock cycles. 

Note that a clock cycle is slightly less than a microsecond. We could say 
“microsecond” when we really meant “CPU clock cycle" and wouldn't really 
be off that much. 

At any rate, 18 CPU clock cycles is more than enough time to flip a few screen 
switches, but is far too short to do the extensive graphics remapping needed for 
animations or game graphics. 

You use the CRUDE module as you would any old subroutine. Just do а JSR 
$0300 from a machine-language program. 

Note that most of these code modules will hang up on an unmodified Apple 
that does not have field sync installed. High-level user software should have 
some extra test included to make sure the field sync mod is in place before any of 
these modules are called. See page 116 for an example. 

Module number 2 is named FEDGE and finds the start of a new field for us. 
What we do is wait till we are sure we are on the blanking part of the scan and, 
then, look for the instant that the live scan starts. This software tool is called an 
edge detector. І you happen to enter during the live scan time, the first ВП test 
spins its wheels till you reach the blanking time. Timing then drops through to 
the second BIT test which also spins its wheels till the start of the live scan time 
that tells us a new field has begun. 

On the other hand, if you happen to enter during the blanking time, the first 
test fails immediately, and you drop through to the second BIT test that loops 
till the start of the next field. 

The advantage of this FEDGE module is that it will: always exit near the 
beginning of the live scan time. Since this module is edge sensitive, it always 
waits till the start of a new field before exiting. 

Like CRUDE, module FEDGE can be used over and over again, once per field, 
as needed. After you exit FEDGE, you can go on and do anything you want with 
the machine. 

There are several disadvantages to using FEDGE. The first disadvantage is that 
this routine will hang up on an unmodified Apple, since SW3 has to change to 
allow an exit. The second disadvantage is that there can be a jitter of up to 7 
CPU clock cycles on the exit. This jitter is trivial compared to the jitter of 
CRUDE, but it is still not acceptable for precision field sync uses. Another 
disadvantage of FEDGE is that almost an entire field can be spent stuck in the 
subroutine if you aren't careful. This means you should adjust the rest of your 
program so that its length doesn't compound the time that it has to waste in the 
subroutine. 

We can easily "inside out" our FEDGE sub to give us а BEDGE subroutine. 
This one is shown as module number 3 and exits on the start of blanking on the 
first available field. If you happen to enter during the blanking time, the first BIT 
test keeps retrying till the live scan time. Then, the second BIT test keeps retrying 
till you reach the start of the blanking time. Then you exit. You exit on the start 
of blanking plus one to seven CPU clock cycles. This leaves you with 70 full lines 
or some 4350 CPU cycles to do good stuff with before the start of the next field. 
This is more than enough time for simple animation where only a portion of the 
screen is to be remapped. 

The ВЕОСЕ subroutine is best used when a medium amount of remapping is 
needed, while the FEDGE subroutine is best for flipping a single soft switch or 
two, or else, when used for remapping so extensive that you are using two HIRES 
pages and taking the entire field or more to update. Otherwise, the two subs 
have the same advantages and disadvantages. 
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Our fourth module is called ALTFLD and will automatically switch you from 
text on one field to graphics on the next. The module works by calling FEDGE, 
switching to graphics, calling FEDGE again, and, then, switching to text. It then 
looks for any key pressed and loops if there is no response. The display will mix 
text and HIRES for you as long as you like. 

You can reach ALTFLD by a JSR to $0330 from a machine-language program. 
Unlike our earlier modules, it is also feasible to directly reach ALTFLD from 
either BASIC. CALL 816 does it. We will see an example of this in Program 4-2. 

This is a very simple field alternator. We may look at fancier field alternators 
in a future enhancement. We've included a simple field alternator here so that 
we have a way to test your field sync mod, and so that you can get started very 
simply and quickly on your own. 

Module number 5 is the big surprise since many people would swear it is 
impossible to measure to an exact clock cycle with software which takes 7 CPU 
clock cycles to read and test at a port. These same disbelievers have gone out 
of their way to build all sorts of totally unneeded and ridiculous hardware so as 
to use things like precision light pens, touch screens, and so on. As we will see, 
it is trivially easy to quickly find any exact screen location using nothing but a 
few bytes of ordinary machine-language software. 

We will look at two methods of doing an exact field lock. A simple software- 
only method appears here but a much faster and more flexible method that takes 
extra hardware will be shown you in Enhancement 13 of Volume 2. 

Module ЕХАСТЕ will find the exact start of a field for you, jitter free. To see 
how it works, we have to carefully look at machine-language instruction timing. 
The following procedure shows us the key secret. 

The following steps illustrate how to do an EXACT screen lock using software. 
Remember that the last part of the FEDGE program looks like this . . . . 


BLANK ВІТ SYNC 
BMI BLANK 
RTS 


What this says is, “Read the port named SYNC. If the port is high, go and read 
the port again. If the port is low, exit immediately." This part of FEDGE is used 
to find the start of the new field for us. 

But, the commands BIT and BMI take time. How much time? The BIT test 
takes 4 clock cycles and the BMI branch takes 3 clock cycles every time it 
repeats. This is a total of 7 clock cycles per try, or roughly 7 microseconds. Thus, 
it would seem that you can only read a port once every 7 clock cycles. 

So, it would appear that there is an “inherent” 7-microsecond jitter in reading 
an outside random event that is routed to a port. And, indeed, there is if you 
read the port ол/у once. 

The preceding simple program will make its “last” measurement anywhere 
between one and seven microseconds after the port input goes low. Let's sup- 
pose that, this particular time around, we just happen to make our “аз!” meas- 
urement at 3 clock cycles into the start of the new field. 

Like во... 


SAY WE HIT HERE 
BLANKING ON FIRST TRY 
WAVEFORM 


1 2 3 
CPU CYCLES 
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There are exactly 17,030 clock cycles in an entire field. Let's do a time delay 
of precisely 17,029 clock cycles and, then, make a new measurement. We are 
now only two microseconds into the next field, since going forward for 17,029 
clock cycles is exactly the same as backing up oneclock cycle on the next field. 

This new measurement turns out this мау... 


NEXT FIELD 


BLANKING WE LAND HERE 
WANEFORM Е 
0 1 2 3 4 
CPU CYCLES 


Now, delay another 17,029 clock cycles and we end up 1 microsecond into 
the next field, since we backed up one more clock cycle. 


AND HERE ON 


BLANKING THE NEXT FIELD 
WAVEFORM 
0 1 2 з 4 
CPU CYCLES 


And, let's do it one final time. Only now, ме “miss” the low part of the 
blanking waveform. But we see that we are EXACTLY at the start of the new field 


with zero jitter. 


So, we exit. 
We have done an exact lock to the blanking waveform... . 


THIS TIME, WE HIT 
THE EXACT START 
AND EXIT JITTER 

FREE 


BLANKING 
WAVEFORMS 


СРИ CYCLES 


The number of fields till lock can be any amount from one to seven, but when 
you finally exit the final measurement, you have an EXACT lock on the last field 


that came up. 
The logic behind a software EXACT lock says . . . 


Find the start of a new field with 
the usual jitter. 
Then, back up one clock cycle per 


field till you miss the start of the 
field. 
Then exit. 


Here's a flowchart that says the same thing... . 
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( start ) 


FIND FIELD f 
EDGE WITH 
USUAL JITTER f 


17,029 
CPU CYCLES 


A BIT test of an absolute location takes 4 CPU clock cycles. A BPL or BNE 
branch needs 3 CPU clock cycles if taken. Thus, the fastest that we can possibly 
retest any absolute memory location seems to be once each 7 CPU clock cycles, 
or roughly once each 7 microseconds. Since you can enter these field sync 
modules at random, this implies that there is an inherent 7-microsecond jitter 
in any software measurement. And, 7 microseconds or 7 CPU clock cycles is 
7 character slots across the screen. So, it looks like we are stuck with a 7- 
microsecond jitter, like it or not. 

T’aint so. 

Now, follow the bouncing ball. One entire field takes 17,030 CPU clock 
cycles, right? So, suppose we do a BIT test and, then, delay exactly 17,029 CPU 
clock cycles, or precisely and exactly 1 clock cycle /ess than one whole field. 
Regardless of where our field-start BIT test ends up, the new one takes place 
exactly 1 CPU clock earlier in the next field. We have backed up precisely 1 
CPU cycle. 

So, all you do is find the rough start of the next field using a code like FEDGE 
and, then, keep backing up one cycle per field till you miss the start. At that 
point, you exit. Your exit will take 2 CPU cycles for the test failed and 6 CPU 
cycles for the RTS, and you start at minus 1 CPU cycle from the field start. This 
exits you exactly 7 CPU cycles into the start of the new field. Remember that 
this leaves you with 25—7=18 CPU cycles in the horizontal blanking time to 
play with. This is more than enough time to set up a split screen, a video wipe, 
or the timing for a light-pen measurement. 

And, it is exact. There is zero jitter. We repeat. This will exact/y find the start 
of a field for you. 

There is a delay program called WAIT that is built into your Apple monitor 
starting at $FCA8. We call this delay subroutine three times in a row to help us 
hit the exact timing that we need to delay 17,029 CPU clock cycles. Actually, 
we pick three magic delay values to total 17,016 CPU clock cycles. The remain- 
ing 13 CPU clock cycles are used up by the three immediate loads, the BIT test, 
and the branch in the loop. 
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What happens is that you find the leading edge of the new field using a 
FEDGE-like code, just like you did before. This gets done with 1 to 7 CPU clock 
cycles of jitter. Then, you back up exactly 1 CPU clock cycle per field till you 
hit the exact field start. 

Then, you exit. 

This is sort of like stopping your car suddenly at an intersection and, then, 
backing up to make sure you really were out of the crosswalk. 

Exact sync does take a while. Up to seven fields may be needed to acquire 
an exact “lock.” This will average out to around three fields or so per try, or 
something like one-twentieth of a second. But, this one-twentieth of a second 
is usually invisible since it is tacked onto the end of whatever it was that 
happened before. 

Note that in light-pen uses, we may have to repeat the backing-up dose again 
when we sense the pen input. Thus, an average of a tenth of a second will be 
needed to hit a light-pen position of one of 40 exact character locations in one 
of 192 exact lines. You can thus easily find any one of 7680 screen locations 
in a tenth of a second by using nothing but a short piece of wire and some pure 
software. 

A tenth of a second is slightly slower than some special hardware might need, 
but since EXACTF eliminates almost all the light-pen circuitry and since it is faster 
than most people can react, it is most useful. 

In Enhancement No. 5, we will look at mixed fields, a brand new and most 
exciting use of EXACTF. With mixed fields, you can mix and match text, HIRES, 
and LORES in any combination anywhere on the screen, as well as doing screen 
splits and dynamic video wipes. 

You can also “inside out” your EXACTF to find the exact start of blanking if 
you want to. We have shown this as module 6 and named it EXACTB. This time, 
you exit exactly 7 CPU clocks into the vertical blanking rather than 7 CPU clocks 
into the next field. 

One limit to EXACTF or EXACTB is that you cannot use either one each and 
every field, like you could the earlier subroutines. The reason for this is that up 
to seven fields may be needed in order to back up to the exact timing exit point 
we are after. This means that you have to keep your exact lock till you are 
finished with it. During the time you keep the lock, each and every CPU clock 
cycle must be exactly accounted for. 

For instance, for light-pen use, after you acquire an exact lock, you have to 
increment software counters for line and position measurement and do whatev- 
er else you need to do to end up with an exact measurement. If you are doing 
a horizontal video split, or other mixed field, your timing must remain controlled 
and constant till you are done. This means that you probably will want to either 
time out your split or else test for a pressed key to exit. Your CPU will be tied 
up till you are done with the display. We will see just how to handle this timing 
situation and how to make room for other program time problems in the next 
enhancement. 

The point is that once you do an exact lock with EXACTF or EXACTB, your 
CPU is 100% committed to the reason why you wanted to lock until you are 
finished. This is unlike the earlier subroutines that quickly return control back to 
your main programs. 

We will note in passing that you can do an exact lock in a fraction of a field, 
rather than in seven fields, if you are willing to add extra hardware. This greatly 
simplifies program coding. Details on this appear in Enhancement 13 of Volume 
2. 

Let's sum ail this up. 
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THE FIELD SYNC MODULES 


CRUDE —£xits sometime during 
the vertical blanking time. It 
probably will bomb if the FS 
mod is absent. it may be used 
each field but must not be 
called twice in a field. 


FEDGE —£xits on the start of a 
new field with some jitter. It 
will bomb if the FS mod is 
absent. It may be used each 
field. 


ВЕОСЕ —ike FEDGE, only exits 
on start of blanking. 


ALTFLD —Switches between text 
and graphics fields continu- 
ously until any key is 
pressed, Needs FEDGE to 
run, and will bomb if the FS 
mod is absent. 


EXACTF —Finds the exact start 
of a field with zero jitter. 
May take up to seven fields 
to do a perfect lock. Will 
bomb if FS mod is absent. 
Lock timing must be con- 
tinued by calling program. 


EXACTB —Like EXACTF, only 
exits on exact blanking start. 


To rehash, use CRUDE for simple field switching if you are sure you won't 
be calling it more than once per field. Use FEDGE when you want the start of 
a field with no danger of catching the same field twice. Use BEDGE if you need 
a medium amount of animation per field. 

Use the ALTFLD for simple text and graphics overlays. Use EXACTF when you 
want to find the start of a field exactly for use with a light pen, touch screen, 
horizontal video split, or horizontal video wipe. Or, use EXACTB to find an exact 
screen location and, then, do lots of setup before the live scan time actually 
Starts. | 

We will see more examples of how to use your field sync іп upcoming 
enhancements. Note that we have kept each sync module separate so you can 
add to them or move them anyway you like. The funny misspellings are done 
so that each module has its own unique label inside a common assembly- 
language source program. 

While we have shown an RTS, or Return from Subroutine, at the end of each 
module, you are free to move any RTS down and stuff as much other machine- 
language code in the subroutine as you like. 

Program number 4-2 shows us a quick way to test your. field sync modifica- 
tion. This Applesoft program loads ALTFLD and FEDGE. It then prints a message 
on Text | and some artwork on HIRES 1. ALTFLD is then called on to superim- 
pose text and HIRES. The text-over-HIRES display continues till you hit any key. 

Your field sync is working if you get the double text and HIRES image with 
no glitches or noise anywhere on the screen. Some flicker is normal with this 
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PROGRAM 4-2 
FIELD SYNC QUICK TEST 


LANGUAGE: APPLESOFT NEEDS: FIELD SYNC MOD 
FEDGE SUB 
ALTFLD SUB 


* * * * * * k k k k k k k k k k k k k k k] 


FIELD SYNC 
QUICK TEST 


VERSION 1.0 


* 

* 

ж 

ҡ 

ж 

* 

* COPYRIGHT 1981 
* BY DON LANCASTER 
* 

* 

* 

* 

* 

* 


AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


eee хх жж Ұ АХ * f + 


k * k k k k k k k k k k k k k k k k k 


REM FIELD SYNC DESCRIBED 
REM IN ENHANCING YOUR 
REM APPLE II, VOLUME I 


REM NEEDS ALTFLD AND 
REM FEDGE FIELD SYNC 
REM SUBROUTINES. 


PRINT "BLOAD FIELD SYNC UTIL 
ITY SUBS": REM CTRL D 


HOME : VTAB 4: REM TEXT 
PRINT "YOUR FIELD SYNC": PRINT 
"IS WORKING IF ... 

VTAB 10: НТАВ 14: PRINT "THE 
SE WORDS": НТАВ 14: PRINT " 

ARE IN A BOX" 

VTAB 16: HTAB 20: PRINT "... 
AND THERE ARE NO 

HTAB 20: PRINT " GLITCHES 
ANYWHERE";: HTAB 20: PRINT 
Б ОК ТНЕ 5СКЕЕМ.": ВЕМ 
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PROGRAM 4-2, CONT’D... 


250 
260 
270 


280 


290 


HGR : HCOLOR= 5: POKE - 163 
02,0: REM GRAPHICS 

HPLOT 80,64 TO 184,64 TO 184 
,98 TO 80,98 TO 80,64 

HPLOT 81,65 TO 185,65 TO 185 
,99 TO 81,99 TO 81,65 

HCOLOR- 1: HPLOT 31,12 TO 31 
‚81 TO 75,81 TO 71,76 TO 75, 
81 TO 71,86 TO 71,76 

HPLOT 29,11 TO 29,16 TO 33,1 

1 TO 33,16: HPLOT 73,78: HPLOT 
73,82: HPLOT 73,80 

HCOLOR- 2: HPLOT 191,81 TO 2 
36,81 TO 236,116 TO 232,112 TO 
240,112 TO 236,116 

HPLOT 189,80 TO 197,80 TO 18 
9,82 TO 197,82: HPLOT 236,11 
3: REM 


FOR N - 1 TO 3000: NEXT N: PRINT 
"": REM BELL CTRL С 

TEXT : FOR М = 1 TO 3000: NEXT 
N: PRINT "";: REM BELL CT 

RL G 


CALL 816: REM CALL ALTFLD 


POKE - 16368,0: REM RESET 

KEY STROBE 

PRINT : PRINT "RUN MENU": REM 
EXIT ON KP 

REM DELETE 995 IF AUTO MENU 
IS NOT IN USE 


END 
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particular use of field sync. You can minimize this flicker by using black and 
white rather than color displays, or by using darker colors rather than white, or 
by minimizing large blocks of text, or by keeping the total screen information 
and display time at a minimum. Proper setting of contrast and brightness on the 
display will also make a big difference. 

Once again, this apparent flicker applies only to some field alternators. Practi- 
cally all other uses of field sync are glitch and flicker free. 

Note that your field sync must have exclusive use of the cassette read circuitry 
and SW3 when it is in use. We have used the phantom “SW3” input of the 
cassette read circuitry instead of the more obvious game paddle SW2 because 
many word processor programs will use SW2 to route a SHIFT key command 
into their programs. 

You have to break your field sync connection any time you use your cassette 
input. Direct entry of the blanking waveform into the IN jack of the cassette is 
not recommended—first, because capacitor C10 is too small and, more crucial- 
ly, because the long and erratic delay in analog amplifier K13 would give 
unpredictable results in precision field sync applications which need an exact 
lock. 

Precision field sync is so important and so exciting that it should be immedi- 
ately added to your Apple and done in a simple, standard, and easy-to-use way. 
Let us know what new uses you find for this exciting new capability $ 


The Apple Assembler source and 
object programs FIELD SYNC 
UTILITY SUBS.SOURCE and FIELD 
SYNC UTILITY SUBS, along with 
the Applesoft program FIELD 
SYNC TESTER are included on the 
companion diskette to this volume. 
АП three programs are fully copya- 
ble. 


A complete set of all parts needed 
to build one field sync modifica- 
tion is included in the companion 
parts kit to this volume. 


Епһапсетепі 


FUN WITH 
MIXED FIELDS 


Mix TEXT, HIRES, AND LORES 
anywhere on the screen using your 
field sync mod and some simple 
support software. Displays are 
glitch and flicker free and open up 
many exciting new uses. The se- 
cret of the 121 LORES colors is also 
revealed. Or, is it? 


FUN WITH MIXED FIELDS 


How would you like to be able to mix and match text, LORES, and HIRES 
together anywhere you like on your Apple screen? It’s a lot easier than you might 
think. All it takes is some simple support software that we'll look at here. We'll 
use it along with the one-wire field sync mod of Enhancement 4. 

Now you can freely mix text and LORES color, even off of the same display 
page, and anywhere you like on the screen. You can title HIRES displays at the 
top and sides, mix HIRES and LORES together, and label LORES bar graphs. You 
can inset and quickly change normal, inverse, or flashing text anywhere on a 
HIRES or LORES display. 

Think of the possibilities! And, the mix-and-match magic of mixed fields can 
be done much simpler and much faster than can be accomplished by using a 
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straight HIRES display. Your memory needs also сап Бе much smaller with 
mixed fields. And, the basic idea behind mixed fields can be easily extended into 
mind-boggling things like video wipes, whole new worlds of animation, external 
video special effects, and true 3-D vibrating mirror displays. 

What is a mixed field? 


MIXED FIELD —An Apple video 
display mode that changes 
between text, LORES, and 


HIRES on the fly, letting you 
mix and match what goes on 
the screen at any instant. 


The exciting thing about mixed fields is that everything is there at once. Since 
the screen is switched “оп the Яу,” there is no flicker like you sometimes get 
with alternating field displays. 

As with any Apple feature, mixed fields have some limits and disadvantages. 
The first is that you have to very carefully set up a display file that is part of a 
display program. This display file controls when modes get changed on the 
screen. The display file isn’t nearly as bad as a shape table, but you still must 
be able to use and understand one before you can get mixed fields to work for 
you. 

The second limiting factor to mixed field displays is that they take up the lion’s 
share of the CPU time when you are using them. Mixed field displays are better 
suited for titles, transitions, and displaying results than for use where you must 
do a lot of real-time computing. We have built in an automatic display timer and 
an option to exit on any key pressed. These give you the continuity you will need 
to use mixed fields. You can easily switch between mixed fields and regular 
displays at any time in a program. 

You also have the option of using up to 4300 or so clock cycles per field for 
things like limited animation, character entry, and so on. The available through- 
put ends up around one quarter of normal with this option. Use of this nondis- 
play time is tricky, since you must either maintain an exact number of clock 
cycles or else resynchronize each field. 

The third limit to mixed fields is that you can get some very awful glitches on 
the screen if you aren't careful. The absolute worst source of the glitches is 
caused by a change Apple made back in Revision 1. This one is easily eliminated 
with the $3.00 Glitch Stomper mod upcoming in Enhancement 6. The remaining 
glitches are easily made invisible once you understand what causes them. You 
can even make the glitches work for you once you really get to know them. 

All in all, though, these limits to mixed fields are easy to get around if you 
spend the time and trouble to understand what field switching is all about. And, 
the spectacular results certainly make it all worthwhile. 


How mixed fields work 


The following example will show how mixed field displays work. The general 
idea behind mixed fields is to flip soft switches in exact/y the same screen 
Position for every successive field. In this example, we do a graph, starting with 
a one-line text title at the top. Then, we do a single LORES horizontal grey line 
separating title from graph. The graph itself consists of Y-axis text on the left and 
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HIRES lines and points on the right. Finally, we do the X-axis stuff in straight text. 
For each and every field, soft switches are flipped in just the right locations to 
make all this happen. 

In order to understand how to do a mixed field display, it is necessary that 
you fully understand the following procedure. 

A mixed field display needs the field sync mod of the previous enhancement 
and an exact locking program called VFFS. Inside VFFS are three sets of files, 
called CONTROL, HPAT, and VPAT. These files are changed to suit your needs. 

For instance, suppose you want to do a fancy graph with a title at the top, 
then a grey bar, then a HIRES graph with ordinary text as the Y axis, then a 
two-line text X axis below. 

Something like this . . . 


2] 


ы + ол 


Y 
A 
“2 
a 
I 
с 
> 


© = № 


Split the display up into horizontal pieces, starting from the top. Each piece 
has to have an identical horizontal pattern on each and every one of its scan 
lines. With VFFS, you are allowed to have four different horizontal patterns. 
These four horizontal patterns can repeat in order as often as you like. 

Our first horizontal pattern is used for the title. It simply switches to text and 
keeps us in text for the eight lines that are needed to put down a row of 
characters .... 


GRAPH TITLE 
Wes ALL TEXT 
Our second horizontal pattern is used for the grey bar. It simply switches us 


to LORES and keeps us in LORES for another 8 lines. We'll use 4 lines for some 
black space under the title, and the second 4 lines for the grey bar. 


BLACK m 


neon ahaa ot on 2... aosan n a o a n a a a a ик n a n n" а ..... . . "а erao a n n a o кек жадысы “аи, 


GREY A Fee ALL LORES 
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Your text and LORES сап be off Ше same display page as long as you use 
multiples of 8 scan lines per mode. 

Our third horizontal pattern is more complicated. It switches to text at the start 
of each horizontal line and then switches to HIRES on the eighth character of 
each and every horizontal scan line. This continues for most of the display, down 
to line number 175. 


EACH SCAN LINE SWITCHES 
FROM HIRES TO TEXT HERE 


EACH SCAN LINE SWITCHES 
"d FROM TEXT TO HIRES HERE 


a 


Our final horizontal pattern goes back to all text, and lasts for the final 16 scan 
lines, going from line 175 to the bottom of the screen at line 191. 


а їй 28 36 48 56 68 РВ 
^ AALS 


W... TWO ROWS ОҒ 
АЦ. ТЕХТ 


VFFS first does an exact lock and, then, repeats its formatted display every 
field. The display ends on a pressed key, a selected timeout, or both. 

This particular example is comparable to VFFS.GRAPH that is used in demon- 
stration Program 5-2. Each new set of file values should be saved under its own 
unique name. 

In the preceding example, any time you read or write to memory location 
$C051, the display will immediately switch to its text mode. Whenever you read 
or write to memory location $С050, the display immediately switches to its 
graphics mode. If you flipped the $С051 switch at the top of the screen and then 
flipped $С050 after 8 scan lines went by, you would end up with a line of text at 
the top of the screen and graphics the rest of the way down. 

Why the eighth line? Because there are eight horizontal raster lines needed 
per character, since each character is made up vertically of seven live dots and 
a blank undot. The number of raster lines usually needed equals eight times the 
number of text lines. As long as you stick with multiples of eight raster lines, you 
can even have your LORES and text come off the same display page! 

Other switches will let you flip between HIRES and LORES, between memory 
page 1 and memory page 2, and between full and mixed graphics. And, since 
the programs we will show you can hit many different locations in the |/O space, 
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you can also flip the annunciator soft switches or read push-button inputs. This 
opens the door to special video effects, singling out one display line for analysis, 
doing animation and wipes, using precision hardware-free light pens, doing 
touch screens, adding grey scale and anti-aliasing, providing sync for 3-D vibrat- 
ing mirror displays, and so on. 

Some very simple field mixing can be done by flipping a soft switch or two 
at any old time during the vertical blanking interval. For fancier field mixes, we 
have to lock to the field start exact/y, using EXACTF or something similar. An 
exact lock is needed anytime you want to change something in the middle of 
a horizontal scan line. 

To use field sync, you set up a switch-flipping program that takes exactly one 
field to complete. You then find the start of a field with EXACTF and, then, drop 
into this switch-flipping program. The program then keeps changing the display 
back and forth for you, putting what you want exactly where you want it. This 
will continue until either an automatic timeout is completed or until a key is 
optionally pressed. 

You can write lots of very simple mixed field programs. One could give you 
changes at the beginning of any horizontal line. Another could give you changes 
along any horizontal line. Yet another could give you a way to inset text, and 
50 оп. 

Instead of all these relatively simple and specialized programs, we will show 
you one fairly fancy machine-language subroutine called the Video Field For- 
matter Sub, or VFFS for short. We will start out with a do-nothing VFFS called 
VFFS.EMPTY. You will then customize the files in this VFFS to do whatever you 
like and, then, rename it. Examples that we will see will include VFFS.BOXES, 
VFFS.GRAPH, and so on. 

VFFS.EMPTY appears as Program 5-1 and can be used to flip up to 11 
switches on each and every one of 192 live scan lines for a total of up to 2112 
display changes per field. 

Probably the best way to understand VFFS is to jump in with both feet and 
use it. An Applesoft demo, called Fun With Field Switches, is shown as Program 
5-2. This demo shows you some mixed field animation, a HIRES plot with text 
vertical titling, a LORES bar graph with text callouts, and a final display that mixes 
three alphabets for you. 

VFFS.EMPTY is a machine-language program that needs a total of around 520 
bytes, including its working files. We have stashed it starting at $8AFF, or 
decimal 35583. You must protect this space from either Applesoft ог Integer 
BASIC use. The HIMEM command can do this for you, either early in an 
Applesoft program or before loading an Integer program. | used this space 
because you can optionally load and protect VFFS in the highest optional char- 
acter slot under Apple’s HRCG Hi-Res Character Generator. 

You can easily relocate VFFS anywhere you like, but any relocation will 
change all the file locations and design worksheets we are about to look at. 


Working files 


The keys to VFFS lie in three sets of files. The simplest file is а one-byte file 
called CONTROL. CONTROL sets the length of time that the display is active 
and decides whether a keypressed exit is allowed. CONTROL is located at 
$8CFB (decimal 36091). Figure 5-1 shows us how CONTROL is used. 

The most significant bit of CONTROL is set to a one to activate the key- 
pressed exit, and cleared to a zero to disable the keypressed exit. The next 
most significant bit of CONTROL is set to a one to activate the automatic 
timeout or cleared to zero for an "infinite" display. The remaining six lowest 
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РАОСВАМ 5-1 
VIDEO FIELD FORMATTER SUB. VFFS. EMPTY 


LANGUAGE: APPLE ASSEMBLY NEEDS: FIELD SYNC MOD 
HIMEN < 
ЗАРЕ: 35583 


ВАЕЕ: 
SAFF: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
SAFF: 
SAFF: 
ВАЕЕ: 


* k k k k * k * Wk k k k k fk 1k КК УК * 


VIDEO FIELD 
FORMATTER SUB 
VFFS.EMPTY 


($8AFF.8D07) 


VERSION 1.0 
( 8-25-81) 


COPYRIGHT 1981 
BY DON LANCASTER 
AND БҮМЕКСЕТІС5 


ALL COMMERCIAL 
RIGHTS RESERVED 


=e че че ча чо әв Sp =e че че ча ча >o че ча 4 че че VO 
* * + F tHe + + в Ен HH * * 


+ eee ee ни 39 39 39 + XR $ * 


хк * k k k k k k k k КККК 


8AFF: THIS PROGRAM LETS YOU MIX 
ЗАРЕ: AND MATCH SCREEN MODES IN 
ЗАРЕ: MANY DIFFERENT COMBINATIONS. 


ВАЕЕ: SCREEN MODE САМ BE CHANGED 
ВАЕЕ: ONCE EACH НВҺАМК TIME USING 
8AFF: FILE "VPATRN". 


8AFF: 
ВАЕЕ: 
SAFF: 
ВАЕЕ: 
ВАЕЕ: 


SCREEN MODE САМ BE CHANGED 
UP TO TEN TIMES PER H SCAN 
USING FILES "НРАТ1" THROUGH 
"НРАТ4". FOUR OR FEWER 

H PATTERNS ARE ALLOWED. 


Эс 4 ча че ча 


ВАЕЕ: SEE ENHANCEMENT #5 OF 
ЗАРЕ: ENHANCING YOUR APPLE II, 
BAFF: VOL I FOR FULL USE DETAILS. 


ВАЕЕ: 
8AFF: 
ВАЕЕ: 
ВАЕЕ: 


ТО USE, БЕТ UP PATTERN FILES 
THEN JSR $8B00 FROM MACHINE 
LANGUAGE OR CALL 35584 FROM 
APPLESOFT. 


~e we хе < 


PROGRAM 5-1, CONT’D... 


с060: 
С000: 
С060: 
С000: 
ЕСАВ: 


48 DUMMY 
49 КЕУВО 
50 SYNC 
51 SWITCH 
52 WAIT 


Se se чо ~e se 


Fun With Mixed Fields 


LOCATION FOR NO-SWITCH 
KEY PRESS CHECK 
VBLANK УТА "SW3" 

VFILE SWITCH LOCATION 
MONITOR DELAY SUB 
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РВОСВАМ 5-1, 


8AFF: 


ВАЕЕ : ЕА 


8в00:20 


8В03:2С 
8В06:10 
8В08:2С 
8BOB: 30 
8BOD:EA 
8BOE:10 
8B10:A9 
8B12:20 
8B15:A9 
8B17:20 
8B1A:A9 
8B1C:20 
8BlF:2C 
8B22:10 


8в24: 


8В24:А0 


8В26:В9 
8в29:30 
8B2B:10 
8B2D:29 
8В2Е:АА 
8B30:9D 
8B33:8D 
8B36:8D 
8B39:8D 
8B3C:8D 
8B3F:8D 
8B42:8D 
8B45:8D 
8B48:8D 
8B4B:8D 
8B4E:8D 
8В51:88 
8B52: F0 
8B54: D0 


CONT’D... 


55 


EXACTF 


BLENK 


; ЖЖЖЖ START 


NEWFLD  LDY 


NXTLN1 


HPAT1 


НР1 


**** EXACT LOCK ТО 


МОР 


JSR SETUP 


SYNC 
EXACTF 
SYNC 
BLENK 


BIT 
BPL 
BIT 
BMI 
NOP 
BPL 
LDA 
JSR 
LDA 
JSR 
LDA 
JSR 
BIT 
BPL 


STALL 
#$ 3B 
WAIT 
#$34 
WAIT 
#$01 
WAIT 
SYNC 
STALL 


#$C0 


VPATRN , Y 
HPAT2 
НР1 

$572 


SWITCH ,X 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 


BOTTOM 
NXTLN1 


FIELD START **** 


^e Se se “4 9e ма че se ~ne че че so ~o 


EVEN PAGE START (FOR НЕСС) 


INITIALIZE KEYBOARD AND 
TIMEOUT 


LOCK TO FIELD EDGE 


FIND FIELD START 
WITH JITTER 

STALL FOR 2 CYCLES 

STALL FOR 3 CYCLES 

DELAY FOR 17029 
CLOCK CYCLES TOTAL 
USING THE MONITOR 
DELAY ROUTINE AND 
THIS LOOP TIMING. 


HAVE WE BACKED TO START? 
NO, GO BACK ONE MORE 


OF FIELD **** 


FOR 192 LINES 


GET LINE PATTERN 


MASK SWITCH COMMAND 


ONE LESS LINE 
AT SCREEN BOTTOM? 
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PROGRAM 5-1, CONT’D... 


8В56:В9 00 8C 102 NXTLN4 VPATRN, У GET LINE PATTERN 
8B59:30 DO 103 НРАТ1 

8в5в:10 00 104 НРАТ4 НРА 

8B5D:29 7F 105 HP4 #$7F MASK SWITCH COMMAND 
8B5F:AA 106 

8в60:90 00 107 SWITCH ,X 

8B63:8D 60 108 DUMMY 

8B66:8D 60 109 DUMMY 

8B69:8D 60 Е DUMMY 

8B6C:8D 60 DUMMY 

8B6F:8D 60 DUMMY 

8B72:8D 60 DUMMY 

8B75:8D 60 DUMMY 

8B78: 8D DUMMY 

8B7B:8D 6 DUMMY 

8B7E:8D DUMMY 

8B81:88 ; ONE LESS LINE 
8В82:Ғ0 ВОТТОМ АТ 5СКЕЕМ ВОТТОМ? 
8В84:р0 NXTLN4 


8B86: 4C BOTTOM BOTTM1 "SPLICE" RELATIVE BRANCH 


8B89:B9 VPATRN,Y GET LINE PATTERN 
8B8C:30 HPAT3 
8В8Е: 10 НР2 
8в90:29 #S7F 
8B92:AA 

8B93:9D SWITCH,X 
8B96:8D DUMMY 
8B99:8D DUMMY 
8B9C:8D DUMMY 
BB9F:8D DUMMY 
8BA2:8D DUMMY 
8BA5:8D DUMMY 
8BA8: 8D DUMMY 
8BAB:8D DUMMY 
8BAE:8D DUMMY 
8BB1:8D DUMMY 
8BB4:88 

8BB5:FO BOTTOM 
8BB7:DO NXTLN2 


MASK SWITCH COMMAND 


w че < ~e < 


dkkkkk 


ONE LESS LINE 
AT SCREEN BOTTOM? 


~s - 99 >a <s че “9 9 >e ~e 99 ~e 9 ~e 
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PROGRAM 5-1, CONT’D... 


8BB9:B9 
8BBC:30 
BBBE:10 
8BCO: 29 
ВВС2: АА 
BBC3:9D 
8BC6:8D 
8BC9:8D 
8BCC:8D 
8BCF:8D 
8BD2:8D 
8BD5:8D 
8BD8:8D 
8BDB:8D 
8BDE:8D 
8BE1:8D 
8BE4:88 
8ВЕ5:ЕО 
8BE7:DO 


8ВЕ9: 


8BE9:A9 
ВВЕВ:20 
8BEE: A9 
8BF0:20 
8BF3:A9 
8BF5:20 
8BF8:60 


00 8C 
9D 
00 
7F 


00 
60 
60 
60 
60 
60 
60 
60 
60 
60 
60 


oF 
20 


146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 


NXTLN3 


HPAT3 
HP3 


VPATRN , У 
HPAT4 
HP3 

#$7F 


SWITCH,X 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 


BOTTOM 
NXTLN3 


Me << 99 че 99 99 99 че 9 ~e ~o 


Me ча ne Ne ~e se 


GET LINE PATTERN 


MASK SWITCH COMMAND 


ONE LESS LINE 
AT SCREEN BOTTOM? 


***** UBLANKING DELAY ***** 


VBSTAL 


$$20 
WAIT 
#$14 
WAIT 
#$06 
WAIT 


~s 99 че Se 99 че че 


DELAY FOR 4472 
CPU CYCLES 
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PROGRAM 5-1, CONT’D... 


8C00:60 179 VPATRN DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8C03:60 

8с06:60 

8С09:60 

8С0С:60 

8COF:60 

8C10:60 š 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8C13:60 

8C16:60 

8C19:60 

8C1C:60 

8C1F:60 

8C20:60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8C23:60 

8C26:60 

8C29:60 

8C2C:60 

8C2F:60 

8C30:60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8C33:60 

8C36:60 

8C39:60 

8C3C:60 

8C3F:60 

8C40:60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8C43:60 

8C46:60 

8C49:60 

8C4C:60 

8C4F:60 

8C50:60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8с53:60 

8С56:60 

8с59:60 

8С5С:60 

8C5F:60 

8C60:60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8С63:60 

8С66:60 

8с69:60 

8С6С:60 

8с6е:60 

8С70:60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8С73:60 

8С76:60 

8С79:60 

8С7С:60 

8С7Ғ:60 
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PROGRAM 5-1, CONT’D... 


8С80:60 60 187 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8С83:60 60 

8C86:60 60 

8C89:60 60 

8C8C : 60 60 

ВСВЕ :60 

8С90:60 60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8C93:60 60 

8C96:60 60 

8C99:60 60 

8C9C:60 60 

8C9F:60 

8CA0:60 60 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8CA3:60 60 

8CA6:60 60 

8CA9:60 60 

8CAC:60 60 

8CAF:60 

8CBO:60 60 96,96,96,96,96,96,96,96, 


96,96,96,96,96,96,96,96 
8CB3:60 60 


8CB6:60 60 
8CB9:60 60 
8CBC:60 60 
8CBF:60 
8СС0:60 


BCC2: ; **** KEYPRESSED AND TIMEOUT **** 


8CC2:20 ВОТТМ1 JSR KEYTIME 


8CC5: 20 JSR VBSTAL ; DELAY TILL NEXT FIELD 
8CC8: 4c JMP NEWFLD 


TAKE CARE OF EXIT 
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PROGRAM 5-1, CONT’D... 


8CCB:2C FB 8C 201 KEYTIME BIT CONTROL 
8CCE:10 08 202 NOKEY 
8Ср0:2С 00 cO 203 KEYBD 
8CD3:10 06 . 204 KEYOK 
8CD5:68 205 

8CD6:68 206 

8CD7:60 207 

8CD8: ЕА 208 

BCD9: EA 209 

ВСрА:ЕА 210 

8CDB: EE 211 ТІМЕХ 


І5 КЕҮ ЕХІТ АСТІУЕ? 


ТООК ЕОК КЕҮ 
КОТ ТНЕКЕ? 
РОР SUBROUTINE 


ЕХТТ 
EQUALIZE 6 


"e 99 че че ча ма чо ча ча NS че 


INCREMENT TIMEOUT 
MULTIPLIER 
IS TIMER ACTIVE? 


8CDE:2C 212 CONTROL 
8СЕ1:50 213 МОТІМЕ 
8CE3:A9 214 #81Е 
8СЕБ: 20 215 ТТМЕХ 
8CE8: DO 216 NOMULT 
8CEA:CE 217 TIMER 
8CED:DO 218 TIMEOK 
8CEF :68 219 

8СЕ0:68 220 

8CF1:60 221 

8СҒ2:ЕА 222 МОТІМЕ 

8СЕЗ:ЕА 223 

8СЕ4:ЕА 224 

8СЕ5:ЕА 225 

ВСЕ6:ЕА 226 NOMULT 

8СЕ7:ЕА 227 

8CF8: ЕА 228 

8СҒ9:ЕА 229 

8СҒА:60 230 ТІМЕОК 


MASK FOR 1/64 
AND TEST MULTIPLIER 


we te se `. 


ONE LESS COUNT 
DONE? 
POP SUBROUTINE 


EXIT 
EQUALIZE 8 


EQUALIZE 8 


ча че че Se ча ма se <o че че че ча ча ме 


ВЕТОВМ ТО МЕХТ $САМ 


8CFB:C4 232 CONTROL $c4 ; ARMS KP AND SETS TIMEOUT 
8СЕС:00 233 ТІМЕК 500 COUNTER FOR TIMEOUT 
8CFD:00 234 TIMEX $00 TIMEOUT * 64 MULTIPLIER 


236 SETUP CONTROL INITIALIZE TIMEOUT 
237 #53Е MASK TIMEOUT BITS 
8D03:8D 238 TIMER 
8D06:60 239 : AND CONTINUE 


*** SUCCESSFUL ASSEMBLY: NO ERRORS 
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РВОСВАМ 5-2 
FUN WITH MIXED FIELDS 


LANGUAGE: APPLESOFT NEEDS: НЕГО SYNC МОО 
HIMEM < 35583 
VFFS. BOXES 
VFFS. GRAPH 
VFFS. GIRLS 


+ k k k k k ККК ККК * * * * КККК VFFS. BYE 


FUN WITH 
MIXED FIELDS 


VERSION 1.0 
(9-26-81) 


COPYRIGHT. 1981 
BY DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


* 
ж 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


* £f f $ Ft FF + * иж HH + 


* k de k k * k k k k k *k k k k k k An  & 


50 THIS PROGRAM SHOWS YOU 
52 HOW TO MIX AND MATCH 
54 TEXT, LORES, AND HIRES 
56 ANYWHERE ON THE SCREEN 
58 IN ANY COMBINATION. 


60 THE FIELD SYNC HARDWARE 
62 MOD AND SUBROUTINES 

64 VFFS.BOXES, VFFS.GRAPH, 
66 VFFS.GIRLS AND VFFS.BYE 
68 ARE NEEDED. 


70 SEE ENHANCEMENTS #4, 

72 REM #5, AND #6 OF ENHANCING 
74 REM YOUR APPLE II, VOL I 

76 REM FOR MORE USE DETAILS. 


100 НІМЕМ: 35500: REM PROTECT 
VFFS SPACE 
110 HGR : TEXT : HOME : СВ : REM 
INITIALIZE ALL 
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PROGRAM 5-2, CONT’D... 


1000 REM ** TITLE BOXES ** 


1004 PRINT 
1005 PRINT "BLOAD VFFS.BOXES": REM 
CTRL D 

1010 SPEED= 10 

1020 VTAB 8: НТАВ 9: PRINT " FU 
N ";: HTAB 25: PRINT " WI 
TH и ; 

1030 УТАВ 15: НТАВ 9: PRINT " МІ 
ХЕР ";: НТАВ 25: PRINT " ЕТ 
ELDS " 

1040 SPEED- 255: REM 


1050 COLOR- 1 

1080 FOR М = 1 TO 3500: NEXT М 

1090 HLIN 6,16 AT 11: HLIN 22,32 
AT 11: HLIN 6,16 AT 18: HLIN 
22,32 AT 18 

1100 HLIN 6,16 AT 25: HLIN 22,32 
AT 25: HLIN 6,16 AT 32: HLIN 
22,32 AT 32 

1110 VLIN 11,18 AT 6: VLIN 25,32 
AT 6: VLIN 11,18 AT 16: VLIN 
25,32 AT 16 

1120 VLIN 11,18 AT 22: VLIN 25,3 
2 AT 22: VLIN 11,18 AT 32: VLIN 
25,32 AT 32 

1125 КЕМ 


1130 PRINT "": FOR N - 1 TO 3500 
: NEXT N 

1140 PRINT "": POKE 36091,212: CALL 
35584 

1145 REM 


1150 HGR : HCOLOR- 2: POKE 49234 
‚О 

1160 НРЬОТ 12,8 ТО 258,8 ТО 259, 
85 ТО 12,85 ТО 12,8 

1169 РОКЕ 49168,0 

1170 HPLOT 12,90 ТО 258,90 ТО 25 
8,170 ТО 12,170 ТО 12,90 

1180 РОВ М = 1 ТО 3500: NEXT М: PRINT 


1190 CALL 35584: REM MIX FIELDS 
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PROGRAM 5-2, CONT’D... 


2000 


2006 
2010 
2015 


2020 
2030 


2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 


2180 


2190 
2191 


2192 
2193 


** GRAPH AND TITLE ** 


H = 62:V = 160 

TEXT : HOME : SPEED= 100 
PRINT "BLOAD VFFS.GRAPH": REM 
CTRL D 

PRINT " DIPTHONG-SNORG 
EL CORRELATIONS:" 

PRINT "................... 


PRINT " 

PRINT : 

PRINT 30 

PRINT А 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 

PRINT 10 -" 

: PRINT : PRINT " 

PRINT PRINT " 

PRINT PRINT " 

1 2 3 4 5 

PRINT : PRINT " 

DIPTHONGS"; 

VTAB 1: НТАВ 0: PRINT " ": SPEED- 
HGR : HCOLOR- 1: POKE 49234 
0 

Li 

HPLOT 63,156 TO 255,156 
HCOLOR- 1: HPLOT 87,157 TO 
87,165: HPLOT 115,157 TO 115 
‚165: HPLOT 143,157 TO 143,1 
65 

HPLOT 171,157 TO 171,165: HPLOT 
199,157 TO 199,165: HPLOT 22 
7,157 TO 227,165: HPLOT 255, 
157 TO 255,165 

GOSUB 20000: REM РІОТ 
HCOLOR- 7: HPLOT 229,32 TO 
229,120 

POKE 36091,208: CALL 35584 
FLASH : VTAB 5: HTAB 34: PRINT 
"1066" 

VTAB 15: HTAB 34: PRINT "14 
92" 

HCOLOR- 7: HPLOT 229,28 TO 
229,128 

NORMAL : CALL 35584: REM M 
IX FIELDS 

REM 
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PROGRAM 5-2, CONT’D... 


3000 REM ** GIRLS ** 


3010 GR : CALL - 1998: РОКЕ - 
16302,0 
3020 PRINT "BLOAD VFFS.GIRLS": REM 


3100 FOR М = 1 TO 10: READ 1: COLOR= 
№: HLIN 0,1, АТ (4 * N - 1): FOR 
К = 1 TO 200: NEXT K,N 

3105 : FOR М = 1 TO 2000: NEXT М 

3107 HGR : HCOLOR- 3: HPLOT 4,17 
4 TO 240,174 TO 243,179 TO 2 
46,169 TO 249,174 TO 279,174 


POKE - 16302,0: 
HPLOT 4,175 TO 4,180: HPLOT 
46,175 TO 46,180: HPLOT 88,1 
75 TO 88,180: HPLOT 130,175 TO 
130,180: HPLOT 172,175 TO 17 
2,180 
HPLOT 214,175 TO 214,180: HPLOT 
270,175 TO 270,180 
FOR М = 1 TO 23 STEP 2 
VTAB (N): FOR К = 0 TO 39: PRINT 
"oU: NEXT К,М 
FOR М = 1 TO 10: READ G$: VTAB 
1 +2 * N: PRINT G$: NEXT N 
PRINT : PRINT : PRINT "0 
2 4 6 8 10 
1";: POKE 2039,160: REM 
AVOID SCROLL 
POKE 36091,212 
CALL 35584: REM MIX FIELDS 


POKE 16368,0: REM RESET KE 
Y STROB 
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PROGRAM 5-2, CONT’D... 


4000 REM *** BYE BYE *** 


4005 PRINT : PRINT "BLOAD VFFS.B 
YE": REM CTRL D 

4008 GR : TEXT 

4009 : POKE - 16368,0: GR : TEXT 


4010 HOME : УТАВ 7: HTAB 20: PRINT 
"BYE "; 
4015 FOR М = 1 TO 1000: NEXT М 
4020 HGR : HCOLOR= 5: HPLOT 143, 
86 TO 143,79: HPLOT 145,86 TO 
145,79: HPLOT 141,78 TO 141, 
77: HPLOT 139,78 TO 139,77: HPLOT 
147,78 TO 147,77: HPLOT 149, 
78 TO 149,77 
HPLOT 137,76 TO 137,73: HPLOT 
135,76 TO 135,73: HPLOT 151, 
76 TO 151,73: HPLOT 153,76 TO 
153,73 
HPLOT 107,73 TO 107,86: HPLOT 
109,73 TO 109,86: HPLOT 119, 
75 TO 119,78: HPLOT 121,75 TO 
121,78: HPLOT 119,81 TO 119, 
84: HPLOT 121,81 TO 121,84 
HPLOT 107,73 TO 117,73: HPLOT 
107,74 TO 117,74: HPLOT 107, 
79 TO 117,79: HPLOT 107,80 TO 
117,80: HPLOT 107,85 TO 117, 
85: HPLOT 107,86 TO 117,86 
HPLOT 163,73 TO 163,86: HPLOT 
165,73 TO 165,86: HPLOT 163, 
73 TO 179,73: HPLOT 163,74 TO 
179,74 
HPLOT 163,85 TO 179,85: HPLOT 
163,86 TO 179,86: HPLOT 163, 
79 TO 175,79: HPLOT 163,80 TO 
175,80 
COLOR= 0: FOR М = 25 ТО 39: 
HLIN 0,39 AT N: NEXT N 
COLOR= 3: HLIN 11,14 AT 25: 
HLIN 11,14 AT 28: HLIN 11,1 
4 AT 31: VLIN 25,31 AT 11: VLIN 
26,27 AT 15: VLIN 29,30 AT 1 
5 


VLIN 25,26 AT 18: VLIN 27,2 

7 AT 19: VLIN 28,31 AT 20: VLIN 
27,27 AT 21: VLIN 25,26 AT 2 

2 

VLIN 25,31 AT 25: HLIN 25,2 

9 AT 25: HLIN 25,28 AT 28: HLIN 
25,29 AT 31 

POKE 36091,128 
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PROGRAM 5-2, CONT’D... 


4100 CALL 35584: REM MIX FIELDS 


4200 PRINT : PRINT "RUN MENU": REM 
CTRL D 
4201 REM DELETE 4200 IF AUTO-ME 
NU IS NOT IN USE 
4210 END 


20000 REM ** SNORGEL CURVES ** 
20005 HCOLOR= 3 


20010 FOR X = 1 TO 200 
20020 У = (1 - (2.718) ^ ( - X / 
50) 


) 
20030 Z = Y * (2.718 ^ ( - X / 60 
)) 


20040 HPLOT X + 61,159 - 137 * Y 
20050 HPLOT X + 61,159 - 457 * Z 


20060 NEXT X 

29999 RETURN 

30000 DATA 2,6,9,16,21,24,27,29 
,31,39 


30100 DATA  VELMA,GERTRUDE,CHARI 
TY,NOREEN, EMILY,PEGGY,ELAIN 
E, SAMANTHA, RACHAEL, YVONNE 
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KEYPRESSED EXIT TIMED EXIT DISPLAY TIME 
1 = activate 1 = timed Six bits hold the 
0 = disable 0 = Infinite number of half-seconds 
in straight binary 


The CONTROL file is presently located at hex $8CFB (decimal 36091). 


The values shown give a keypressed exit along with a timeout exit 
after seven seconds. 


Some CONTROL file use examples: 


. Keypressed exit only—use hex $80 or decimal 128. 

. Four-second display only—use hex $48 or decimal 72. 

. Four-second display with keypressed exit—use hex $C8 or 
decimal 200. 

. Eight-second display only—use hex $50 or decimal 80. 

. Eight-second display with keypressed exit—use hex $00 or 
decimal 208. 


To set up CONTROL in hex, start with $00 and add $80 if keypressed 
exit is wanted. Add $40 if timeout is wanted. Add TWICE the number 
of seconds of timeout to this value (max. timeout value = $3F). Store 
this value in $8CFB. 


To set up CONTROL in decimal, start with 0 and add 128 if keypressed 
exit is wanted. Add 64 if timeout is wanted. Add TWICE the number of 
seconds of timeout to this value (max. timeout value - 63). Роке this 
value into 36091. 


Do not use a CONTROL value of hex $00 or a decimal 0 as this will give 
a permanent display. 


Fig. 5-1. CONTROL file used in VFFS. 


bits hold a binary number equal to the number of half seconds you wish to 
display. For instance, for a ten-second display, you would load decimal twenty, 
or hex $14, into these six bytes. 

Timeout range goes from one-half a second to thirty-two seconds, with the 
option of an “infinite” timeout exited with a pressed key. 

Next are the HPAT files, short for Horizontal Patterns. The following example 
shows us the HPAT addresses and data value. There are four possible horizontal 
pattern files used in VFFS. These files decide which soft switch is flipped in any 
of ten exact horizontal screen positions. 

The files are called HPAT1 through HPAT4. The display always starts with 
HPAT1. Each HPAT file continues for a number of scan lines set by the VPAT 
file shown in Table 5-1. While the HPAT files must be sequenced in order, they 
can repeat as often as you like each field. 
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Here are the present addresses of the pattern files . . . 


HPAT1 ADDRESSES HPAT2 ADDRESSES 


Switch-on Hex Decimal Switch-on Hex Decimal 
Character Address Address Character Address Address 


$8B34 35636 $8B97 35735 
$8B37 35639 $8B9A 35738 
$8B3A 35642 $8B9D 35741 
$8B3D 35645 $8BAO 35744 


$8B40 35648 $8BA3 35747 
$8B43 35651 $8BA6 35750 
$8846 35654 $8BA9 35753 
$8849 35657 $8BAC 35756 


$884С 35660 $8BAF 35759 
$8B4F 35663 $8BB2 35762 


HPAT3 ADDRESSES HPAT4 ADDRESSES 


Switch-on Hex Decimal Switch-on Hex Decimal 
Character Address Address Character Address Address 


$8BC7 35783 $8B64 35684 
$8BCA 35786 $8B67 35687 
$8BCD 35789 $8B6A 35690 
$8800 35792 $8B6D 35693 


$8BD3 35795 $8B70 35696 
$8BD6 35798 $8B73 35699 
$8BD9 35801 $8B76 35702 
$8BDC 35804 $8B79 35705 


$8BDF 35807 $8B7C 35708 
$8BE2 35810 $8B7F 35711 


Note that any address in the 1/О space below $C100 may also be flipped by 
using its hex address minus $C000, or its decimal equivalent. Note, also, that 
any change or relocation of the VFFS program will change all these address 
locations. 

HPAT is really working code rather than a true file, so its soft switching “Ме” 
values only show up every third byte. HPAT splits up the screen horizontally 
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Here are the data values used т ап НРАТ file. . . . 


HPAT DATA VALUES 


Switch Hex Decimal 


Graphics ON $50 
Text ON $51 
Full Screen $52 
Mixed Graphics $53 


Page ONE $54 
Page TWO $55 
LORES Graphics $56 
HIRES Graphics $57 


Do Nothing $60 


into ten groups of four characters each. At the beginning of each four-character 
slot, you have the option of flipping one soft switch. 
For instance, suppose we use this HPAT code . . . 


8833: 8D 60 CO STA DUMMY ; Flipdummy softswitch 
8836: 8D 50 CO STA TEXT ; Switchtotext 

8839: 8D 60 CO STA DUMMY ; Flipdummysoftswitch 
8B3C: 80 60 CO STA DUMMY ; Flipdummy soft switch 
8B3F: 8D 51 CO STA GRAFIX ; Switchto graphics 


8842: 80 60 СО STA DUMMY  ; Flipdummy softswitch 
8845: 80 60 СО STA DUMMY  ; Flipdummy softswitch 
8848: 8D 60 CO STA DUMMY  ; Flipdummy soft switch 
8848: 8D 60 CO STA DUMMY ; Flipdummy soft switch 
8В4Е: 8D 60 CO STA DUMMY ; Flipdummy softswitch 


What this will do is display the first four characters as graphics, the next twelve 
as text, and the remainder of the line as graphics again. Which type of graphics 
and which page text is decided by how the other soft switches have been previ- 
ously flipped. 

Note that you only have to flip a soft switch when you want to produce a 
change in the output mode. If you flip to text, you stay that way till you flip to 
something else. 

Each STA absolute store command takes 4 CPU clock cycles, which is equal 
to 4 characters. Thus, the 10 switch flippings will equal the horizontal live- 
character scan time of 40 CPU clock cycles. 

To use this particular HPAT file, we access it with some machine-language 
code that goes through the “file” exactly once each horizontal line. The timing 
is very carefully set up so that the first switch flips before character Zero, the 
second one before character Four, the next one before character Eight, and so 
on, across the screen to the final switch that flips before character Thirty-six. 

Because our back is to the wall with CPU operating speeds, we aren't free to 
flip only those switches we want to. Instead, we must flip 10 soft switches each 
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and every horizontal line. To do this, we fill in with dummy soft switches. A 
dummy soft switch is one that flips but doesn’t do anything. One good dummy 
soft switch is a write to location $С060. This 15 the cassette IN location, and the 
hardware here is read-only. So, you can write to location $C060 all day long 
and nothing will happen. By coincidence, $C060 is also read as part of the exact 
locking code. These two uses of one address space location will not cause 
conflict. 

What you usually do is start with a VFFS.EMPTY file that holds all dummy soft 
switches. Then, you modify that file by changing the code locations you need 
to flip the "live" switches you really want in the exact slots where you want 
them. The easiest way to change these locations is to display the file in machine 
language and, then, use the monitor commands to modify only the locations you 
want. You can also change a VFFS file by poking from Applesoft, by reading 
Applesoft data statements, by transferring the commands from another ma- 
chine-language file, ог by reading a new “Пе” off your disk. 

И we had only one HPAT file, we could only have one combination of text, 
HIRES, and LORES which would have to repeat each and every horizontal line 
all the way down the screen. At the other extreme, we could have 192 separate 
HPAT files that would let us change each horizontal line any way we liked, 
separate from all the others. But this, of course, would take bunches of code and 
would be horribly complex. 

Instead, we have shown you four HPAT files, called HPAT1 through HPATA. 
This lets you have four different horizontal patterns. We will see that we have 
an option of changing to the next HPAT file at any scan line we like. Thus, you 
could use НРАТТ for fifteen lines, HPAT2 for six lines, HPAT3 for 97 lines, and 
HPATA for two lines. If we like, we can go round and round back through the 
HPAT files as often as we want to on the same field. The next field always restarts 
with НРАТТ. 

Four different horizontal patterns that can be repeated is more than enough 
for text insets and some really fancy field mixing, yet it keeps our program and 
pattern files down to something manageable. 

Our final file is called VPATRN. VPATRN does two things for you. It first lets 
you flip an eleventh soft switch during each horizontal blanking time. This extra 
switch can be handy in going, say from text page One to HIRES page Two. You 
can use this extra and hidden switch any way you want to. The second thing 
that VPATRN does for you is let you advance to the next available HPAT file 
any time that you like. 

To repeat, the VPATRN file lets you flip one soft switch invisibly during the 
blanking time of each horizontal line. It also optionally lets you change to the 
next available HPAT horizontal pattern. A c/eared MSB in a VPATRN file loca- 
tion only flips a soft switch, while a set MSB in the file both flips a soft switch 
and moves on to the next available HPAT file. Should no soft switching be 
wanted, a dummy or “‘do-nothing” switch location is substituted. 

Table 5-1 gives the addresses of the VPATRN files . . . . 


Table 5-1. VPATRN Vertical Pattern File Used in VFFS 


Character LORES line 
anddot | number 
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Table 5-1 Cont. VPATRN Vertical Pattern File Used іп VFFS 


Character LORES line 
and dot number 
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Table 5-1 Cont. УРАТЕМ Vertical Pattern File Used т VFFS 


Character LORES line Decimal 
and dot number address 
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Table 5-1 Cont. VPATRN Vertical Pattern File Used in VFFS 


Character LORES line 
and dot number 
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Table 5-1 Cont. VPATRN Vertical Pattern File Used іп VFFS 


Character LORES line Hex 
anddot number address 


Note that any soft switch in the 1/О space below C080 may be flipped. Use 
its hex address minus $С000 if a new НРАТ is лоно be used, or its hex address 
minus $BF80 if a new HPAT js to be used. Note also that any change ог 
relocation of the VFFS program will change all these address locations. 

There are 192 entries in the VPATRN file, arranged from the bottom to the 
top of the screen. These entries start out as $60 values which end up stored at 
%С060 as dummy writes to the cassette IN read-only location. Changing a value 
to $54, for instance, causes a soft switch to flip to page One. A $55 flips you 
to page Two, and so on. Or, for far out uses, a $59 will set annunciator ANO 
at the start of a chosen vertical line, and a $58 will clear ANO. 

If a VPATRN file entry has its most significant bit set, it will flip the intended 
soft switch and automatically advance us to the next available HPAT file. If the 
VPATRN entry has its most significant bit cleared, it will flip the intended soft 
switch but will not change the HPAT file in use. 

For instance, a $51 entry will flip you to text and keep the old HPAT in use. 
A $D1 will both flip you to text and advance to the next HPAT. Note that $51 
+ $80 = $01. И the most significant VPATRN file bit is set, then HPAT gets 
flipped. Н the MSB is cleared, then HPAT stays the same. 


144 Enhancement 5 


The following are the data values used in а VPATRN file . . . . 


Switch Advance HPAT? Hex Data Decimal Data 


Do Nothing 
Graphics ON 
Text ON 

Full Screen 
Mixed Graphics 
Page One 

Page Two 


LORES Graphics 


HIRES Graphics 


The main VFFS program is set up to always start on НРАТТ at the top of the 
screen, and continue from there. Values in the VPATRN file will decide when 
and if a change to HPAT2, HPAT3, and so on, is to be done. If you are using 
HPAT4 and you get a change command, you switch back to HPAT1 and go 
round and round. 


VFFS DETAILS 


Note that all these CONTROL, HPAT, and VPATRN file locations will change 
if you relocate the program or make any other modifications to it. 

What you do ahead of time is make up a VFFS.EMPTY program with all 
dummy soft switches in VPATRN and the four HPAT files, along with some 
sensible value for CONTROL, say a four-second display with keypressed active. 
You then modify these files to do the exact display job you want. For many uses, 
only a few file locations need be changed. 

A pair of worksheets that make file design a lot easier appear in Figs. 5-2 and 
5-3. The easiest way "ме found to change an HPAT or VPATRN file is to simply 
list itin machine language on the screen, and then change the dummy locations 
as needed. You then save VFFS under a new modifier name to pick up these 
special locations. 

To use these worksheets, first split your display up into horizontal blocks, each 
of which has a distinct horizontal pattern. Then, write the modes into the top 
of the HPAT file worksheet, putting a “ТЕХТ” in the block where you want text 
to start appearing, and so on. Then, put the right data value in the right box on 
the correct HPAT for each switch flipping. To finish your HPAT worksheet, 
calculate the line number or numbers where you want to switch from HPAT1 
to HPAT2, and so on. Put these numbers in the bottom boxes. 
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Now go to the VPATRN worksheet, and label the changes you want in the 
positions you want. Then, substitute the code needed beside each position. Note 
that you can count in scan lines, in 8 scan-line character units, or in 4 scan-line 
LORES units. 

When you have completed both worksheets, you should have a list of all file 
values that you need. Load VFFS.EMPTY, modify these file values, change 
CONTROL as needed, and resave your new VFFS under a new name. The whole 
process is much easier to do than to describe. 

Let’s look at some more details of VFFS.EMPTY that appear as Program 5-1. 
A flowchart is shown in Fig. 5-4. 

To activate VFFS, you first create your own custom version and then load it 
into your Apple. Then, you do a JSR $8B00 or a CALL 35584. Your VFFS will 
then do a mixed field display for you for the length of time that you selected 
with your CONTROL data values. 

At the start of VFFS, your Apple is still displaying whatever it happened to have 
on the screen. Nothing visible will change until an exact lock to video timing is 
completed. Once again, you must have the one-wire sync mod of the previous 
enhancement in place for mixed fields to work. 

We first do some setting up at $8B00. This takes the timeout bits from 
CONTROL and moves them to a location called TIMER where they can be 
counted down for timeout. We then find the exact start of a video field using 
code we borrowed from EXACTF of the last enhancement. This code must have 
the field sync modification of Enhancement 4 to work. What EXACTF does is 
find the beginning of a field with some jitter and, then, backs up one CPU clock 
cycle per field till it finds an exact field start. 

We get to $8824 exactly at the start of a field. We call this location NEWFLD 
since it is the point we will return to after each field is complete. Timing from 
now on is exactly controlled to take up precisely one field per trip around. Up 
to this point, the Apple is still displaying whatever it happened to be showing 
before we began. 

NEWELD tells us the number of live scan lines we are to use. This is usually 
hex $CO or decimal 192. The number of live scan lines is put in the Y register 
and Y counts the lines down for us. We then grab a value from the VPATRN 
file for the top line. This is done with an indexed load, taking the sum of the start 
of the МАТЕМ file at $8С00 and the value in Y. Thus, our top line appears as 
VPATRN byte $8CCO. 

We next test the value found at $8CCO to see if we are to flip to the next 
HPAT. If $8CCO has its MSB cleared, we use HPAT1; if the MSB is set, we switch 
to HPAT2. This is done with the BMI test at $8829. 

Assuming that we don't want to change HPAT just yet, we go on through the 
code starting at $8B2F. We first flip the VPATRN byte switch invisibly during 
the blanking time and, then, go on to switch up to ten locations set by the HPAT1 
file. 

We reach the right end of the screen on the first scan line when we get to 
$8B51. We subtract one line from our scan counter and repeat the process, 
taking exactly 65 CPU cycles to get right back where we started from, but one 
horizontal scan line down. 

This goes on and on until we either reach the bottom of the screen, or else, 
until we find a VATRN value that flips to us to HPAT2. The time it takes to switch 
between HPAT files is exactly the same as the time it takes to continue with the 
same HPAT file. The apparent order of the HPAT files is “juggled” in the 
program to keep all the relative branches from pattern to pattern in range. 

The process repeats every scan line. A VPATRN byte is gotten and tested to 
see if a switch to the next HPAT is needed. Then, the chosen HPAT scan is done, 
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чольоо-о 
ЯЕСКЗВВЕ 


$8C8C $8C5C $8C2C 
CHARACTER 1 CHARACTER 7 CHARACTER 13 CHARACTER 19 

$8CBO 58С80 112 160 $8C20 
$8CAF $8C7F 113 161 $8C1F 
$8САЕ $8C7E 114 162 $8C1E 
$8CAD $8C7D 115 163 $8C1D 
$8CAC $8C7C 116 164 $8C1C 
$8САВ 58С7В 117 165 $8C1B 
$8CAA $8С7А 118 166 $8С1А 
$8СА4 76 $8С74 124 172 $8C14 


VERTICAL PATTERN WORKSHEET FOR 
CHARACTER 0 CHARACTER 6 CHARACTER 12 . CHARACTER 18 
$8CCO $8C90 96 $8C60 $8C30 
$8CBF $8C8F $8C5F $8C2F 
$8CBE $8C8bE $8C5E $8C2E 
ззсво 
$8CBC 
$8CBB $8C8B $8C58 $8C2B 
$8CBA ЗВСВА ЗВСБА $8C2A 
$8CB9 58с89 58С59 $8C29 
$8CB8 $8C88 104 $8C58 152 $8C28 
$8CB7 105 $8C57 153 $8C27 
$8CB6 106 $8C56 154 $8C26 
$8CB5 107 $8C55 155 $8C25 
$8CB4 108 $8C54 156 $8C24 
$8CB3 109 $8C53 157 $8C23 
$8CB2 110 $8052 158 $8C22 
$8CB1 111 $8C51 159 $8C21 
LORES 2/3 LORES 14/15 LORES 26/27 LORES 38/39 
$8CA9 $8C79 119 167 $8C19 
LORES 4/5 LORES 16/17 LORES 30/41 
CHARACTER 3 CHARACTER 8 CHARACTER 21 
$8САЗ 77 $8C73 125 173 $8013 
$8CA2 78 $8C72 126 174 $8C12 
$8CA1 79 $8C71 127 175 $8C11 


$8C8D $8C5D $8C2D 
LORES 0/1 LORES 12/13 LORES 24/25 LORES 36/37 
CHARACTER 2 CHARACTER 8 CHARACTER 14 CHARACTER 20 
$8САЗ 72 58С78 120 168 $8C18 
$8CA7 73 $8C77 121 169 $8017 
$8САб 74 $8076 122 170 58С16 
38СА5 75 $8075 123 171 $8C15 


LORES 6/7 LORES 18/19 LORES 42/43 
CHARACTER 4 CHARACTER 10 CHARACTER 16 CHARACTER 22 


$8CA0 

$8C9F 

$8C9E 

$8C9D $8C6D 179 58С00 

58С9С $8C6C 180 58С0С 

58С9В $8С6В 181 $8СОВ 

$8C9A $8C6A 182 58СОА 
58с99 58С69 183 $8609 

LORES 8/9 LORES 20/21 LORES 32/33 LORES 44/46 


CHARACTER 5 СНАВАСТЕЯ 11 CHARACTER 17 CHARACTER 23 


$8C98 136 $8C38 184 
137 $8C37 185 

$8C36 186 

$8C35 187 

$8C34 188 


$8070 176 $8010 
58СӨҒ 177 $8COF 
$8C6E 178 $8COE 


$98898$28 


22882838 


$8097 
58С96 
58С93 58С33 189 
$8C92 58С32 190 
DATA VALUES 
PAGE! РАОЕ2 LORES HIRES — DUMMY 


$8095 
58С94 
58С91 $8C31 
LORES 10/11 CORES 22/23 LORES 34/35 
SAME HPAT | seo | SAME НРАТ 
NEW HPAT NEW HPAT 


Fig. 5-3. Vertical pattern VFFS worksheet. 
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Fig. 5-4. Flowchart of VFFS. 
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flipping switches across the live part of the screen. During horizontal retrace, we 
knock one off the line number and get a new VPATRN value. 

Eventually, we reach the bottom of the screen. Our test of the line number 
fails, and we drop first to location BOTTOM and, then, jump to ВОТТМТ. This 
absolute jump is needed because we go out of the allowed range for a relative 
jump. It is also more flexible this way, since you can substitute your own code 
for the entire vertical blanking interval. 

Our default processing for the vertical blanking time starts at $8CC2. We first 
see what Ше keypressed and timeout sub is up to. This sub is called КЕҮТІМЕ, 

KEYTIME first checks to see whether we are interested in a keypressed and 
then checks for an actual keypressed. If we want a key exit and if a key has been 
pressed, we return to the calling program in whatever language it was in. If not, 
we continue. 

KEYTIME then increments a location called TIMEX. TIMEX is a multiplier that 
multiplies each count of the timeout value in CONTROL by 32. Thus, we only 
decrement the “half-seconds” count in TIMER only once every thirty-second 
field or, roughly, once each half second. 

A check is then made to see if timeout is active, and if we are in the magic 
1-of-32 field that lets us decrement the timeout counter. Should we timeout, we 
exit to the main program. If not, we go back to our ВОТТМТ processing. 

Note two things. First, the code in KEYTIME seems a little complex, but it has 
to be done this way so that each and every possible route through the code, that 
returns us to a repeat field scan, takes ир exact/y the same time. Anything else 
you do during the vertical blanking interval must also be set up to exactly take 
a precise and known number of CPU clock cycles for each and every possible 
direction through the code. 

Secondly, note we have two different types of subroutine returns. If we simply 
RTS, then we kick back into our calling program, which is the BOTTM1 code 
of VFFS. If we pop the stack twice, removing the return address to VFFS, then 
we return to the main calling program in whatever language it happens to be. 
So, do an RTS to get back to VFFS, or else, a PLA-PLA-RTS to get back to your 
main calling program. 

Assuming we haven't pressed a key or used up our timeout, we will normally 
return to ВОТТМТ. At this point, we have to delay exactly 4472 CPU cycles 
to get to the exact start of a new field. This is handled by a subroutine called 
VBSTAL. VBSTAL provides our vertical blanking delay for us. It does this by 
calling the WAIT delay subroutine in the monitor at $FCA8 three times over, 
with just the right magic numbers stuffed into the accumulator to give us exactly 
the delay you need. 

If you like, you can replace VBSTAL with any other program that takes exactly 
4472 CPU clock cycles to repeat. This can give you a limited amount of anima- 
tion or key entry while your mixed field display is active. Once again, the exact 
number of cycles used is critical and must be the same for each and every path 
through your code. 

When VBSTAL is complete, we jump to NEWFLD and repeat the whole game 
over and over again till our timeout is complete or a selected key is pressed. 

Your VFFS subroutine can be relocated to any protected space in memory, 
but note that all the file locations will change and all the worksheet values will 
be wrong if you try this. 

As a hint of some of the really mind-boggling stuff you can do with mixed 
fields, think about what happens if you modify your files while they are running. 
This lets you do video wipes and other animation, where the screen modes 
change dynamically. 

Heavy. 
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GLITCH RIDDANCE 


The first few times you try to use the VFFS subs, you probably will get some 
ugly glitches messing up your display. 

Your most obvious glitch source is caused by you not having what you think 
you do in your VPATRN and HPAT files. Be very careful and very patient in 
deciding what you want to put where on the screen. Use the worksheets. Note 
particularly that your HPAT values go every third byte in the program. When 
you list an HPAT, the HPAT values usually are placed in the slot one byte higher 
than the address shown on the screen. 

For instance, if you have an 


$8B30- 80 60 СО STA $С060 


on your HPAT listing, it is location $8B31 that holds your soft switch value, and 
NOT location $8B30. The first byte of this code says to absolute store some- 
thing. The second byte tells us the exact location on a particular memory page, 
and the final byte tells us exactly which page. Your HPAT value must fit into the 
middle slot and not either of the others. Mix these up and your program bombs 
for sure. 

It is also a good idea to use every early slot left over on НРАТТ to reaffirm 
that your display is showing what you think it should be. As an example, you 
might want to flip the switches for page One, LORES, and full-screen display 
even if you never get out of these modes. That way, if you enter from some other 
part of a program or with a screen in the wrong mode, things will correct 
themselves immediately. 

There are two more sources of glitches. Any time you flip into or out of LORES 
on screen, you will probably get the darndest half-and-half split HIRES/text 
glitch you ever saw. This happens if you are using a Revision No. 1 or newer 
Apple and it is caused by a switching change that Apple made to pick up extra 
HIRES colors. You can reduce this ugly glitch to one that can easily be handled 
by adding another modification to your Apple. 

This modification is called a Glitch Stomper and is detailed in Enhancement 
6. Your Glitch Stomper can be built for $3.00 and in a few minutes time, and 
it is easy to add to your Apple. 

The final glitch problem comes about.since there is always one character “іп 
the pipe” being processed, at the instant that you flip a soft switch... . 


GLITCH KILLING RULE 


There is always one 
character or byte “іп the 
pipe" at the instant that 

you flip a soft switch. 


Say you flip from text to HIRES. What this rule says is that the next text 
Character after the switch flips gets displayed as HIRES lines rather than dots. 
Or, going backwards, a flip írom HIRES to text says that the HIRES dot pattern 
of the next byte айег Ше switch flipping gets put on the display as a dot matrix 
character. 
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Now, that sounds just awful. But, you can carefully make each and every 
glitch on the screen invisible with some care. You can even make a glitch work 
for you, rather than against you. 

For instance, when you go from text to LORES, exit to LORES black. If the text 
and LORES are on the same display page, the black LORES character has the 
same code as a text inverse @. 

Н you go from text to HIRES, if the next text character after the last live one 
is the blank character, you will get a vertical green line on the screen as your 
first HIRES display byte. What is happening is that the least significant seven bits 
of your ASCII text character, following the last valid text character, are displayed 
as HIRES. A text blank has the binary code 1010 0000. The most significant bit 
tells us to shift to HIRES color set “1,” and the remaining “1” gives us a green 
line. 

When you are building a HIRES graph, a green vertical line may be exactly 
what you want, and we get this “free.” You can get most any other HIRES 
pattern in this slot that you want, as long as all eight horizontal scan lines have 
the same pattern on them. If you force a $80 into the character slot following 
the last valid one, you will get both a black HIRES display andan invisible 
glitch. 

If you go from HIRES to text on the live part of the scan, you will get an inverse 
(9 as your first text character if the HIRES display was black at this point. This 
is caused by black being all zeros in the HIRES space and an inverse (9 in the 
text space. The way to get rid of your inverse @’s is to change the code on the 
HIRES page to give you one vertical line through dot number 6 of the character. 
This will exit you to an ASCII code of blank. 

Any other time that a glitch rears its ugly head, find out what character or byte 
is in which memory location. Then, find out what that character or byte looks 
like in the code that you just switched го. Then, change the character to make 
it invisible or otherwise useful. 

Another obvious way to eliminate glitches is to use the VPATRN switches as 
much as possible. These switch during the horizontal blanking time and, there- 
fore, any funny stuff will be off screen. 

Glitch-riddance rules for very old “Revision 0" Apples will be slightly more 
complicated since the switching will take place one dot into the character. Have 
fun. 

Summing ир... 


Glitches happen only during live 
scan switching. 


The Glitch Stomper of the next 


enhancement converts really bad 
LORES glitches into workable ones. 


By carefully studying where the 
code comes from and where it is 
going, all glitches can be made 
invisible, or else they can be made 
to work for you. 


Some practice is all that it takes to build yourself some completely glitch-free 
displays that will mix and match text, HIRES, and LORES in any way that you 
like. 
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VFFS. EMPTY 


НРАТ 1 
FILE 


HPAT 4 
FILE 


HPAT 2 
FILE 


HPAT 3 
FILE 


о 4A A oA 


VPATRN 
FILE 


CONTROL 
FILE 


E 


Fig. 5-5. Hex dumps of VFFS files used in 


TWO DEMOS 


Program 5-2 is a HIRES demo program that loads several different VFFS 
subroutines for you. These subroutines are called VFFS.BOXES, VFFS.GRAPH, 
VFFS.GIRLS, and VFFS.BYE. You'll find hex dumps of these shown in Fig. 5-5. 
Once again, all of these custom field mixers are created by starting with 
VFFS.EMPTY, listing it in machine language, changing a few locations using 
your pattern worksheets, and, then, saving the result to disk under a new name. 

The demo program also shows us how we can mix action during normal 
display times with stunning results during mixed field times. We've purposely 
slowed things down with SPEED commands and lengthy calculations to make 
the demo more interesting to watch. 

Our demo first mixes text with color LORES boxes and, then, for an encore, 
puts a pair of HIRES boxes around the whole works. Actually, we stay in a 
3-way HIRES-LORES-text mix all along. The HIRES parts are black at first. 


We then draw a graph that uses HIRES for the axis and curves, and which uses 
text for the vertical and horizontal data values. Above that is a text title. Note 
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МЕЕЗ. 
РА 


ВУЕ 
вс 2с 60 СО 10 


ВАРР- 
8800- 20 Е! 

8в08- 2с 60 СО 30 РВ ЕА 10 00 
8810- А9 38 20 А8 РС А9 34 20 
8В18- АВ РС А9 01 20 АВ ЕС 2С 
8В20- 60 СО 10 ЕС АП СО 89 00 
8B28- 8C 30 63 10 00 29 ?Ғ АА 
8В30- 90 00 CO 8D 52 CO 8D 60 
8B38- CO 8D 60 CO 8D 60 CO 8D 
8B40- 6G CO 8D 60 CO 8D 60 СО 
8848- 8D 60 CO BD 60 co BD 60 
8B50- CO 88 FO 32 DO DO B9 00 
8858- ВС 30 DO 10 00 29 7Р АА 
8в60- 90 00 CO 8D 60 со 8р 60 
8В68- CO BD 60 СО 80 60 СО 6D 
8В70- 60 CO 8D 60 CO 8D 60 СО 
8в78- 8D 60 CO 8D 60 со BD 60 
8в80- CO 88 FO 02 DO DO 4C C2 
8888- вс B9 00 BC 30 30 10 00 
8В90- 29 7Р АА 9D 00 CO 80 60 
8B98- CO 8D 60 CO 8D 60 CO 8D 
8BAO- 60 CO 8D 60 CO вр 60 СО 
8ВА8- 8D 60 CO Вр 60 СО 8D 60 
8880- CO 80 60 CO 88 FO CP DO 
8вв8- DO B9 00 8C 30 9D 10 00 
8BCO- 29 7P AA 9D OO CO 8D 60 
BBC8- CO 8D 60 CO 8D 60 CO 8D 
BBDO- 60 CO 8D 60 CO 8D 60 CO 
BBD8- во 60 CO 8D 60 со вр 60 
8BEO- CO BD 60 CO 88 FO 9F DO 
8BE8- DO A9 20 20 AB ЕС А9 14 
ӨВРО- 20 АЗ PC A9 06 20 A9 ЕС 
8Вғ8- 


8со0- 
8С08- 51 60 60 60 60 60 60 60 
8С10- 57 60 60 60 60 60 60 60 
8С18- 50 57 60 60 60 60 60 60 
8C20- 51 60 60 60 60 60 60 60 
8С28- 50 60 60 60 60 60 60 60 
8С30- 51 60 60 60 60 60 60 60 
8C38- 50 60 60 60 60 60 60 60 
8с40- 51 60 60 60 60 60 60 60 
8С48- 50 60 60 60 60 60 60 60 
8с50- 51 60 60 60 60 60 60 60 
8С58- 50 60 60 60 60 60 60 60 
8с60- 51 60 60 60 60 60 60 60 
8С68- 50 60 60 60 60 60 60 60 
8С70- 51 60 60 60 60 60 60 60 
8C78- 50 60 60 60 60 60 60 60 
8С80- 51 60 60 60 60 60 60 60 
8С88- 50 60 60 60 60 60 60 60 
8С90- 51 60 60 60 60 60 60 69 
8С98- 50 60 60 60 60 60 60 60 
ВСАО- 51 60 60 60 60 60 60 60 
SCA8- 50 60 60 60 60 60 60 60 
8СВ0- 51 60 60 60 60 60 60 60 
8С88- SO 60 60 60 60 60 60 50 
8СС0- 51 60 20 СВ ЕС 20 E9 8B 
8сс8- 4C 24 6B 2C ЕВ 8С 10 08 
8С00- 2C 00 CO 10 06 68 68 60 
8CD8- EA EA БА ЕЕ FD GC 2C РВ 
8CEO- 8C 50 ОР A9 ІР 2D PD 8С 
8СЕЗ- DO ОС СЕ FC 8C DO OB 68 
BCPO- 68 60 EA EA EA EA EA BÀ 
6cF8- 
8D00- 


VFFS. GIRLS 
EA 
E BC 2C 60 CO 10 FB 


"Fun With Mixed Fields" demo programs. 


the use of a vertical HIRES line in order to get rid of an on-screen glitch in line 
2220. 

After our graph is complete, we then inset some flashing text inside the HIRES 
display. It is usually very tricky to have flashing text in the middle of a HIRES 
screen. Mixed fields make it trivial. 

The subject of our next plot is obvious. We show how to do a LORES 
horizontal bar graph with text documentation. A HIRES graph axis completes the 
picture for us. 

The final display in the Fun With Mixed Field demonstration program shows 
how you can have a LORES, HIRES, and text words on the screen at the same 
time right above each other. 

A totally different kind of Applesoft demo appears as Program 5-3. This one 
is called LORES COLORS 121 and shows 121 of the many available LORES 
colors. We purposely aren't going to tell you how this one works. But, if you 
combine the detective work you should have picked up in Enhancement 3 with 
a good understanding of your VPATRN and HPAT files from this enhancement, 
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LORES 1 (DISPLAY PAGE 1) 


VFFS. LORES 


Note: These values must be indirectly loaded since they are an "IMAGE" o! text page 1. 


Fig. 5-6. Hex dumps of VFFS and SCREEN files 


you will be well on your way to thoroughly understanding some machine 
language secrets. 


Fig. 5-6 shows us hex dumps of the VFFS.LORES subroutine, along with two 
display page files called LORES1 and LORES2. The companion diskette to this 
book has these programs ready to go, and also includes two programs called 
LOREST CREATE and LORES2 CREATE. You can modify these CREATE pro- 
grams for other LORES color demonstrations. Do not run either CREATE pro- 
gram with a locked LORES1 or LORES2 on the same disk or you will get an error 
message. 

Note that you cannot directly “Напа load” LORES1 since this is on the display 
page. Instead, you save a version from $0800 to ФОВЕЕ onto your disk and, then, 
read this VERSION into $0400 to $07FF. The demo disk does all this for you. 

Oh, yes. One gotcha. Before you can use an Applesoft program such as 
LORES COLORS 121 and page Two LORES or text together, you have to make 
sure the Applesoft program starts above memory location $0С00. The copy of 
Program 5-3 that is on the disk has an automatic repositioner built in. The disk 
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LORES 2 (DISPLAY PAGE 2) 


Note: Page iwo text must be protected 10 use this fisting. 


used in the LORES COLOR 121 demonstration. 


version of LORES COLORS 121 will run just like any ordinary program. But, if 
you are trying to copy the LORES COLORS 121 program from this book, do a 
POKE 104,12 and a POKE 3072,0 from the keyboard before entering the 
program and, again, immediately before every use. Always turn your Apple off 
and back on again before running anything else on the machine. We might look 
at repositioning details in a future enhancement. 

So far, | have been able to find only 136 LORES colors. Sorry about that. | 
left the ugliest 15 colors off the display on purpose. But, even these uglies might 
be useful in order to add texture to a black and white display. How many new 
LORES colors can you find? 

There are lots of possible VFFS options and improvements since mixed fields 
is a brand new ball game. You might like to write a program that will automatical- 
ly generate custom VFFS files for you. You might like to modify VFFS.EMPTY 
to put a “phase shifter” between the exact lock and the rest of the program. This 
lets you switch on characters 0,4,8, . . . , or characters 1, 5,9,..., or characters 
2, 6, 10,..., or characters 3,7,11, . . . , per your choosing. The really good 
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РАОСВАМ 5-3 
LORES COLORS 121 


LANGUAGE: 


APPLESOFT NEEDS: FIELD SYNC MOD 
VFFS. LORES 
RELOCATION ABOVE TEXT 2 
LORES 1 
LORES 2 


'k 'k ke k k k k k k k k k k k k k k k k k] 


LORES COLORS 121 


COPYRIGHT 1981 
BY DON LANCASTER 
AND SYNERGETICS 


VERSION 1.0 

( 9-20-81) 
ALL COMMERCIAL 
RIGHTS RESERVED 


* 
ж 
х 
ҡ 
ж 
ж 
ж 
ж 
ж 
ж 
* 
* 


X * XO ЛЕ He ЛЕ ЛЕЛЕ ЛЕ: 


* * * k k k k k k k k k k k k k k k k 


THIS PROGRAM NEEDS THE 
FIELD SYNC MODIFICATION 
AND BINARY FILES LORES1, 
LORES2, AND VFFS.LORES 
TO WORK PROPERLY. 


SEE ENHANCING YOUR 
APPLE II, VOLUME 1 
FOR MORE USE DETAILS. 


WARNING: THIS PROGRAM 
MUST BE RELOCATED 
ABOVE TEXT PAGE Two! 


DO A POKE 3072,0: 

AND А РОКЕ 104,12 
BEFORE USING. THIS 

IS DONE AUTOMATICALLY 
IN THE VERSION OF THIS 
PROGRAM ON THE DEMO 
DISK. 
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PROGRAM 5-3, CONT’D... 


100 


HOME : GR : РОКЕ - 16302,0: 
CALL - 1998: REM CLEAR FU 
LL GRAPHICS SCREEN 


PRINT "BLOAD VFFS.LORES": REM 
CTRL D 

PRINT "BLOAD LORES1": REM С 

TRL D 

PRINT "BLOAD LORES2,A$800": REM 
CTRL D 

CALL - 29952: REM MIX FIEL 

DS 


POKE - 16300,0: TEXT : HOME 


POKE 2048,0: POKE 104,8: PRINT 
: PRINT "RUN MENU" 

REM DELETE 405 IF AUTO MENU 
IS NOT IN USE 


PRINT "PLEASE TURN APPLE POWE 
R OFF AND BACK ON AGAIN BEF 

ORE RUNNING ANY OTHER PROGRA 

M. 

PRINT : PRINT : PRINT "! HAS 

ТА LA BYE BYE": VTAB 23: END 
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stuff will happen when you start flipping nonobvious soft switches, for things like 
external 3-D displays, anti-aliased grey scales, and so on. And, the opportunities 
for dynamic "change-while-it's-running'' field-switch animation and wipes аге 
awesome. 

By the way, if you try flipping the speaker or cassette soft switches out with 
VFFS, you'll have to replace any involved HPAT “8D” absolute stores with 
“AD” absolute loads instead. Due to an Apple quirk, stores whap each soft 
switch twice. This puts the speaker cone right back where it was two mi- 
croseconds earlier and it produces no sound. 

Now, it’s your turn. What can you do with mixed fields? In the back of this 
volume is a postcard. Use it to show us the best use of mixed fields that you 
can think of. Pay particular attention to flipping nonobvious switches like the 
annunciators and whatever. We'll work up the best of the best into future 
enhancements that everyone can share 4 


The following programs and files 
are included on the companion 
diskette to this volume: 


VFFS.EMPTY.SOURCE 
VFFS.EMPTY 
VFFS.BOXES 
VFFS.GRAPH 
VFFS.GIRLS 

VFFS.BYE 
VFFS.LORES 

FUN WITH MIXED FIELDS 
LORES COLORS 121 
LORES1 CREATE 
LORES2 CREATE 
LORES1 

LORES2 


All are fully copyable. 


Enhancement 


GLITCH STOMPER 


This simple, three dollar, add-on 
hardware mod makes the mixed 
field displays of Enhancement 5 
even more powerful. The mod lets 
you glitchlessly switch to and from 
LORES anywhere on the screen. 


GLITCH STOMPER 


As we promised you in Enhancement 5, here is a fairly simple mixed fields 
add-on hardware mod that will eliminate the worst of the on-screen glitches as 
you switch to or from LORES on any live portion of your screen. The glitch 
stomper works on any Apple—from Revision 1 on. It costs under $3.00 and is 
fairly easy to install or remove. It is only needed for mid-screen LORES field 
switching. 
up the extra HIRES colors during Revision 1. Their idea was to make a few 
changes as simply and cheaply as possible to the existing Revision 0 Apple 
board. But, what they forgot, and what we are about to find out 5... 


With hardware or software, there 
NEVER is such a thing as a small 


change! 
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and even more to the point . . . 


When you do make any change in 
hardware or software, anything 


you ignore will surely return to 
haunt you. 


In the case of the Apple mod, the thing that the Apple people ignored is that 
someday someone might like to instantly switch to or from LORES while in the 
middle of a live scan. The changes that they made require one character time 
in order to complete a switch to or from LORES. During that time, you get some 
very ugly glitches that are a mix of both text and HIRES. 

Fig. 6-1 shows us the Apple circuitry that is involved in the modification. A 
one-of-eight electronic selector was originally provided at location A9 on the 
Revision @ Apple boards. This selector switch was set up so that the code on 
the “A,” B," and “С” select lines picked the source of the video to be routed 
to the display. When the original switch was in any of positions Zero through 
Three, you got a text output. This text output came from a 2513 dot matrix 
character generator by way of a serial video-shift register at A3. 


7415151 
VIDEO 
SELECTOR 
A9 


TEXT 


Fig. 6-1. Video selector used in Revision & Apple boards. Line “С” unconditionally picks 
text or graphics. 


HIRES and LORES were input to positions Four through Seven of this switch. 
On Revision 9 boards, the HIRES and LORES were separated in earlier circuits 
and one or the other, but not both, would go to selector A9. When in a graphics 
mode, A9 would use its four graphics input positions to complete sorting out the 
dots on either a HIRES cell or a LORES color block. 

Note that the switching between text and graphics here was unconditional. 
Whenever select line “С” with а weight of 4” was low, you went immediately 
to the text side of the switch. When select line "C" went high, you went to the 
graphics side of the switch. Since all four low inputs went to the same text 
source, it didn't matter what selector line “А” (weighted 1), and selector line 
"B" (weighted 2), were up to. 

Now for the problem. Fig. 6-2 shows the same selector switch after the HIRES 
color modification, and as used on all Apples of Revision 1 and higher. Now, 
the bottom two switch positions are text, the next two are HIRES, and the four 
high ones àre LORES, all separate. One of the HIRES inputs is delayed one- 
quarter of a color cycle from the other, giving you a choice of two sets of colors, 
depending on whether the most significant bit of the HIRES word was a one or 
a zero. 
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74LS151 
VIDEO 
SELECTOR 
Ag 


чотроюзо 


SELECT 
LINES 


ини 
Е - 


—,h 
O m > 


Fig. 6-2. Video selector circuit used in newer Apple boards. Line “C” is no longer 
unconditional. 


Nice and neat. 

Except for the problem. To go into text or HIRES, you now have to pay 
attention to all three select lines, instead of using only select line “C” to uncondi- 
tionally go to text like before. Apple very carefully worked things out so that the 
select signals would point exactly to the right switch position. Lines “B” and “C” 
must work together to unconditionally output text or HIRES. 

The only little hassle is that the logic to keep everything pointing in the right 
place ends up one character behind the character you think you are on when 
you suddenly switch display modes. It takes the Apple one character more to 
complete the switching to or from LORES and to either text or HIRES. 

The result of this is an ugly glitch. Fig. 6-3 shows you what you get. When 
you suddenly switch out of LORES, you get a symbol that is split into two vertical 
halves. The top half will be the dot matrix display of the character still stuck in 
the pipe, while the bottom half will be a HIRES mapping of the actual ASCII code 
bits of that same “іп the pipe” character. Thus, the top half is the character and 
the bottom half is the code that forms that character. 


Assume you just switched from LORES to TEXT or HIRES 
in the middle of a horizontal line. If the NEXT LORES value 
happens to be hex $52, here is what you get: 


i TOP HALF OF UNSTOMPED GLITCH 
-—— IS DONE IN DOT MATRIX TEXT. IN THIS 
CASE, A FLASHING "R." 


TYPICAL7 x 8 — 
CHARACTER CELL 


BOTTOM HALF OF UNSTOMPED GLITCH 
——— 15 DONE IN HIRES. IN THIS CASE A 
0100 101 PATTERN. 


Fig. 6-3. Typical one-character unstomped glitch that you get on a sudden mid-scan 
Switch out of LORES. 


The problem to you, as field mixer, is that while you can “hide” either half 
of this glitch by a choice of what character you put here, you cannot get rid of 
both halves of the glitch at once. Something always remains to haunt you and 
foul up the display. 
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What we have to do is make sure that your selector switch instantly goes into 
the chosen text or HIRES mode when you switch out of LORES, instead of 
waiting for the Apple circuit to straighten things out for you on the next character 
slot. Make this correction and you still get a “wrong” character, but the “wrong” 
character is now at least in one entire piece. By picking the character code, you 
can now make this glitch invisible, or else, have it work for you one way or 
another, We saw details on this in Enhancement 5. 

The problem lies in selector line “В.” All line “А” can do is pick even or odd, 
50 it can't point us temporarily to text while in HIRES, or vice versa. And, line 
"C" is what picks LORES on one hand and text or HIRES on the other. So what 
we have to do is make sure that line “В” immediately points to text or HIRES 
the instant that we do a field switch out of LORES. 

Fig. 6-4 shows the schematic of the glitch stomper. What we do is intercept 
line “B” of the selector, and force it to a “zero” the instant that we go into a 
text mode, and to a “опе” the instant that we go into а HIRES mode. Should 
we be in LORES, the signal that is supposed to be on line “В” passes through 
unharmed. 

This speeds up the Apple switching logic by one character, so we can instantly 
Switch to an all-text mode, an all-HIRES mode, or back to LORES anywhere on 
the screen. Any glitch that remains is in one piece and is easy to handle by 
changing its code to something useful or invisible. 

We will now show you how to make this mod using three new integrated 
circuits. While you only need one new 14-cent IC to do the job, we are going 
to chop and channel the other two in a way that the Apple warranty people 
might find suspect. When the mod is done, two of Apple's integrated circuits 
will be left over. You can set these aside for use in case you ever need a warranty 
repair. 

Ав with the hardware mods in the other enhancements, this one does in fact 
void your Apple warranty. But, if you are careful, you can easily and completely 
return things back to normal. 

Here are the parts you will need. . . 


PARTS LIST FOR 
GLITCH STOMPER 


( ) 74LS02 quad NOR gate 
IC (2 needed). 


( ) 74LS151 1-of-8 
selector IC. 


( ) DIP socket, 16-pin, 
premium machined-pin 


style. 

No. 24 insulated solid 
wire, 4-1/2 inches 
long, red. 

No. 24 insulated solid 
wire, 4-1/2 inches 
long, blue. 


Electronic solder (5 
inches). 
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BREAK OLD 
CONNECTION 


DEVICE 
10/A9 


74LS02 "PIGGYBACK" 
ONTO EXISTING А12. 


PIN 7 = GROUND 
РМ 14 = +5 VDC 
PIN +6 = NO CONNECTION 


Fig. 6-4. Schematic of the glitch stomper modification. 


Неге are the tools you will need . . . 


TOOLS NEEDED TO BUILD 
GLITCH STOMPER 


( ) Small soldering iron, 40 watt 


( ) Diagonal-cutting pliers 


( ) Needle nose pliers 

( ) Wire stripper 

( ) Piece of protective IC foam 
( ) IC puller (optional) 

( ) Phillips screwdriver 

( ) Regular small screwdriver 


Construction details for your glitch stomper are shown in Fig. 6-5. Be sure to 
use a premium machined-pin DIP socket. This is the only type that can safely 
be plugged into another socket without damage. Also, be certain you understand 
how DIP pins are numbered. 

Installation is slightly harder than the earlier mods since the case of your 
Apple will have to be temporarily removed. Here is how to install your glitch 


stomper .... 
INSTALLING THE 
GLITCH STOMPER 


1. Put a rug or other soft 
cover over your work 
area. 


2. Turn Apple OFF. Then 
unplug both ends of 

the Apple power cord 
and set the cord aside. 
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3. Pop Ше cover on your 


Apple by pulling 
sharply up—first at left 
rear, and then right rear. 


. Remove all plug-in 


cards, cables, rf 
modulator leads, and 
other add-ons. Make a 
careful record of what 
goes where. 


. Turn the Apple upside 


down onto the rug. 
Using a Phillips 
screwdriver, remove 
two screws at extreme 
reat, two on either 
extreme side, and four 
from the front. 


NOTE — Remove 
ONLY these 10 

screws. Do not let the 
case separate from the 
rest of the Apple. 


. Carefully grab both the 


case and the chassis of 
the Apple and turn 
them both back 
right-side up together. 
Do not let case 
separate from 

chassis when you 

do this. 


. Gently lift the front of 


the case only far 
enough to look inside. 
Note the keyboard 
connector. Now, lift 
the case up and back 
as far as you can 
without stressing the 
keyboard connector. 


You should be able to 
rest the case on the 
power supply and on a 
book or two. 


. Verify that there is a 


7415151 integrated 
circuit in location A9. 
This is in the front 
row, somewhat right of 
center. 
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9. Remove Ше 7415151 
at А9 and set it aside. 
Plug the DIP socket of 
the glitch stomper into 
location A9, being 
careful that the red 
and blue wires exit to 
the left rear and that 
pin number 1 is on the 
front right. 


10. Remove the 741502 ІС. 
located at A12 and set 
it aside. Plug the 
stacked 74LS02-end of 
the glitch stomper into 
this socket. Be sure the 
red and blue wires exit 
to the left rear and pin 
1 is to the front right. 


11. Check the pictorial of 
Fig. 6-6 to be sure you 
have everything in the 
right place. 

12. Set the cover back in 
place. Some Apples 
will have a hook at 
the right rear that goes 
into a slot in the case. 
If yours does, make 
sure the hook fits into 
the case slot. 


13. Carefully hold case 
and chassis together 
and turn them back 
upside down. Do not 
let them separate. 


14. Replace the ten 
Phillips screws holding 
case to chassis. 


15. Replace all plug-in 
cards, cables, and 
whatever. 


16. Replace cover, but 
leave the line cord 
unplugged till you 
complete checkout. 


17. Label and store your 
“extra” integrated 
circuits. Save these 
should a warranty 
repair be needed. 
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INSTRUCTIONS FOR BUILDING 
THE GLITCH STOMPER 


1. Cut the blue wire into two pieces, one 3% inches long and 
one % inch long. Strip 3/16 inch of insulation from each end. 


Do the same to the red wire. 


2. Carefully identify pin 10 of the machined-pin DIP socket. If 
you have a second 16-рт DIP socket available, plug this 
machined-pin socket into it. This will keep the pins aligned 
should the plastic soften. Insert one end of the 334-inch blue 
wire into pin 10 of the DIP socket. Then solder this wire in 
place. 


Position the wire so that it lies flat as shown. Remove the dum- 
my socket if you used one. 


3. Carefully identify pin 10 of the 7418151 1-of-8 data selec- 
tor. Bend this pin straight out as shown. Tin this pin with a very 
smal! amount of solder and, then, solder one end of the 334 
inch red wire to pin 10 of the 74LS151. 


Make sure that pin 10 does not point downward or short to ad- 
jacent pins. 


4. Plug the 74LS151 into the machined-pin DIP socket, making 
sure that pin 1 of the IC goes to pin 1 of the socket. 


Route the wires as shown and temporarily set this half of the 
modification aside. 


5. Press a 74LS02 quad NOR gate into a piece of protective 
foam. Carefully tin the very tops of pins 7, 10, 12 and 14 with a 
small amount of solder. 


Make sure no solder reaches the part of the pins that must fit ІК; ode 
the socket. ON 
6. Solder one end of the 34-inch blue wire to the very top of pin / 
12 of the 74LS02 as shown. NOT 

HERE! 
Then, solder one end of the 34-inch red wire to the very top of 
pin 10 of the 741502. 

SHORT SHORT 

RED ..-——— BLUE 
Make sure there are no pin-to-pin shorts and that you can still 
plug thís IC into a socket. SOLDER 

741.502 


8 8 10 11 12 13 14 


Fig. 6-5. How to build 


9 г 
| 


5 
4 сит? 
12 3 AND #14 
2 LIKE THIS 
BEND ALL ч 1 
BUT #7 AND #14 

STRAIGHT OUT 


SOLDER 
FLAT AND #7 ТО #7 AND 
SQUARE #14 TO #14 


8 сш”) 

9 = | L == 6 
CONNECT ОД [25 
#10 ТО #11 u SI m 


набеги ТОР 
V 1р) 741502 


BLUE WIRE 


LONG <——,0NG BLUE WIRE 
RED — 

PINS #1-6 
WIRE ARE NOT 


CONNECTED 
6 


Glitch Stomper 


7. Take a second 741502 quad NOR gate and bend pins 1 
through 6 straight out. Then, bend pins 8 through 13 straight 
out. 


Then, cut 1/16 inch off the very ends of pins 7 and 14. Tin these 
pins with a small amount of solder on the cut ends. 


8. Piggyback the second 74LS02 quad NOR gate onto the first 
74LS02 quad NOR gate so that pins 7 and 14 of each IC contact 
each other and so that the top IC sits square and flat on the 
bottom one. 


Solder pin 7 to pin 7 and separately solder pin 14 to pin 14. 
Make sure both ICs “point” the same way and that you can still 
plug the bottom IC into a socket. 


9. On the top 74LS02, bend the tip of pin 11 so that it faces pin 
10 and bend the tip of pin 10 so that it faces pin 11. 


Solder these two pins together. 


10. Take the free end of the short blue wire coming from pin 
12 of the bottom 741.502 and solder this wire to pin 9 of the 


upper 74LS02 as shown. 


Then, take the free end of the short red wire coming from pin 
10 of the bottom 74LS02 and solder this to wire to pin 12 of the 
upper 74LS02 as shown. 


Note that the two wires should cross each other, forming an 
ip а 


11. Take the long blue wire coming from the data selector half 
of your mod and solder this wire to pin 8 of the upper 74LS02, 
as shown. 


Then, take the long red wire coming from the data selector half 
of your mod and solder this to pin 13 of the upper 74LS02, as 
shown. 


12. Carefully check your glitch stomper against the schematic 
of Fig. 6-4 and the pictorial of Fig. 6-6. 


13. This completes your glitch stomper modification. See text 
for installation and checkout details. 


your glitch stomper. 
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Неге is how to check your glitch stomper modification . . . . 


GLITCH STOMPER 
CHECKOUT 


. Turn the Apple OFF 
and plug in the line 
cord. 


. Very briefly, turn the 
Apple on and, then, 
back off again. The pilot 
lamp should light and 
there should be only a 
single click from the 
power supply. 


. Turn the Apple on and 
hit RESET, followed by 
a few random keys. You 
should get a text 
message. 


. Get into BASIC, and, 
then, type GR. Top of 
screen should go to 
black. Then, do a 
COLOR = 5 followed 


by a HLIN 0,25 AT 10. 
You should get a color 
line on the black 


screen. 


. Keep typing keys and 
returns till you get down 
screen. The usual text 
should appear in the 
usual mixed graphics 
mode. 


. Type HGR. Screen 
should go black. Type 
HCOLOR = 3, and, 
then, HPLOT 0,100 TO 
100,0. You should get a 
single diagonal line on 
the screen. Check for 
normal mixed text on 
the bottom. 


. Run the FUN WITH 
MIXED FIELDS demo. 
Everything should work 
with no glitches. 
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Fig. 6-6 shows you a pictorial view of your installed glitch stomper. The 
sidebar given back in Enhancement 2 shows you how to read Apple’s compo- 
nent locations. 


(DADAPTER MADE @ JUMPER WIRES @PIGGYBACK PAIR OF 
FROM PREMIUM DIP MODIFY LINE “В” 74LS02's IS PLUGGED 
SOCKET AND MODIFIED TO STOMP GLITCH INTO А12 


7415151 PLUGS INTO А9 


sit P 
| 


= 


м 


печ 
- 


а! 


lf 


Ет: 


FRONT OF APPLE II 
MAIN BOARD 


Fig. 6-6. Pictorial shows glitch stomper modification in place. 


Should you not get the pilot light to come on or should the power supply click 
more than once, STOP IMMEDIATELY. This means you have a short in the 
mod— most likely caused by an upside-down ІС. If you end up stuck in text 
mode or stuck in HIRES, this means that you have a problem on the upper 
74LS02—most likely caused by a short or a pin mixup. However, any problems 
at all are very unlikely since this is a straight and simple modification. 

The glitch stomper is totally invisible except when you suddenly switch on- 
screen from LORES to text or HIRES, and should not interfere with any other 
intended use or attachment to your Apple. The additional power-supply current 
is very low, so you can leave the glitch stomper in place all the time. 

The glitch stomper is a simple enough and powerful enough modification that 
we hope Apple will add it themselves to future revisions of the Apple main pc 
board % 


A complete set of all parts needed 
to make one glitch stomper 
modification is included in the 


parts kit that is companion to this 
volume. 


Enhancement 


GENTLE SCROLL 


This simple software add-on gives 
your 48K Apple Па crawling or 
gentle scroll for easy reading of 
upward-moving text. The gentle 
scroll is compatible with the high- 
resolution character generator. 


GENTLE SCROLL 


Have you ever been infuriated by how your Apple’s text jumps up the screen 
during a normal scroll? Most personal computers and practically all video termi- 
nals share this same hangup. Yet, it is surprisingly simple and easy to add a 
protected and invisible machine-language subroutine to your 48K Apple II that 
will give you a smooth and continuous flow of your text up the screen. 

| call this enhancement а gentle scroll. Fig. 7-1 shows us the differences 
between a gentle scroll and an abrupt, or ordinary, scroll. In your usual abrupt 
scroll, the characters move up on the screen an entire character line at a time. 
Thus, each character dot reappears eight dots above where it was before, 
making it just about impossible to read anything while scrolling. The gentle scroll 
only moves up one dot at a time, giving you the ///usion of a continuous or 
crawling text that is very easy to read. During each movement in a gentle scroll, 
the message only travels one-eighth as far up the screen. Thus, eight movements 
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In an abrupt ог conventional scroll, words move up EIGHT 
dots at a time. You can not read the screen while it is 
scrolling. 


In a gentle scroll, words move slowly up the screen, ONE 
dot at a time. You can easily read the screen while it is 
scrolling. Eight gentle scrolls replace one abrupt scroll. 


Fig. 7-1. A gentle scroll is far better looking and easier to read than a conventional or 
abrupt scroll. 


are needed in succession for the same displacement as one old-style abrupt 
scroll. 

You can do a gentle scroll either with hardware or software. | first tried the 
hardware route and found that elaborate changes in the Apple's system timing 
would be needed, along with other hassles. Therefore, we will be using a 
software subroutine instead that works on any 48K, or larger, Apple microcom- 
puter. While this gentle scroll is intended for use in a protected CHARAC- 
TER.SET slot under Apple's HRCG (High-Res Character Generator), supplied 
with the DOS Toolkit, this gentle scroll will work from most any host program in 
almost any language. It should be compatible with any other character generator 
that uses the HIRES screen for display. 

More and more programmers are going the HIRES route for character display 
because of the variety of fonts that you can have, the stunning animation and 
wipe possibilities, the mixing of graphics and text anywhere on the screen, the 
wide color range and text-over-color choices, and so on. 

Note that our gentle scroll is оп/уа gentle scroll. It does not map characters 
onto the HIRES page for you. All the gentle scroll does is move any existing 
characters or graphics smoothly up the screen. The НЕСС is an ideal host 
program to initially enter characters. The HRCG interacts with the gentle scroll 
by replacing its own incredibly ugly abrupt scroll with a subroutine call to the 
gentle scroll. While you do not have to use the HRCG, you will need some other 
host program to get the characters on the screen and to decide when a scroll 
is needed. 

We will show you a simple Applésoft test program that does not need а 
character generator. This will get you started but, later on, you will want to add 
НКСС or something similar so as to make best use of your new gentle scroll 
capability. 

Fig. 7-2 shows us how we do a gentle scroll. We use HIRES page One for our 
main text display. Every time we want to do a gentle scroll, the host program 
(HRCO) calls the gentle scroll subroutine. This subroutine then starts mapping 
from page One to page Two, going up one dot row. Then, we remap from page 
Two back to page One, going up a second dot row, and so on. We repeat this 
eight times, ending up back on page One with our text smoothly moved up the 
screen. Only the page we are mapping from ever gets displayed on the screen, 
so everything appears smooth and continuous. One call to the gentle scrolling 
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TO DO A HIRES GENTLE SCROLL. . . 


озы. | AND MAP TO 
UH AND MAP TO 
овес | АМО МАР ТО 
DISPLAY [2] АМО МАР ТО 


Fig. 7-2. Ном а gentle scroll is done 
DISPLAY AND MAP TO 


using pages 1 and 2. 
DISPLAY [2] АМО МАР ТО 


DISPLAY [+] AND MAP TO 
DISPLAY [2] АМО МАР ТО 
DISPLAY [+] 


THIS SMOOTHLY MOVES EVERYTHING ONE 
CHARACTER ROW (6 DOTS) UP THE SCREEN. 


. THEN. .. 


. THEN... 


. THEN. .. 


. THEN... 


THEN... 


. THEN. .. 


. THEN... 


FINALLY... 


Esj Eon pep pes КАЙ Се Е е 


subroutine does а! eight mappings needed to smoothly move up one complete 
row of characters. With the field sync modification of Enhancement 4, the 
remapping can be made totally invisible. Without this field sync mod, the results 
are still acceptable but not quite as nice. 

While a gentle scroll can be done by remapping a single HIRES page, we have 
chosen this two-page route for maximum possible speed and smoothness. 


THREE PROBLEMS 


If a gentle scroll is so fast and easy, why wasn't it available since Year One, 
and why can't you get it on most other personal computers? It turns out that 
there are three problems that interact to make a gentle scroll somewhat tricky. 
These three hassles involve the eye's perception of motion, collisions caused by 
the raster scan, and the remapping time needed to get from one HIRES page to 
another. Let's look at these hassles one by опе.... 


Motion perception 


This is the simplest of the problems. If you present to the eye two events that 
are separated by less than 10 milliseconds, both events will appear to exist at 
the same time. If you take over 100 milliseconds between events, then one event 
will clearly be seen to happen after the other one, and a distinct jump will be 
seen between the two. 

It is only when you present two events faster than 10 milliseconds, or slower 
than 100 milliseconds, that the eye “#5 іп” with the illusion of a smooth and 
continuous motion. Television uses a 60-field per second rate while most movies 
use a 48-field per second rate. Both these values center in the range where the 
eye best senses apparent motion. 

The exact speed range over which you can get a smooth illusion varies with 
the contrast, the image, and many other things, but this 10- to 100-millisecond 
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area is where we have to aim if we expect to obtain any smooth and useful 
results. 

The Apple presents us with 60 fields per second. This is equal to one field of 
video every 17 milliseconds. Which tells us that a single scroll should take 
somewhere between one and six fields to accomplish an action if we are going 
to get smooth results. We will split the difference and use four fields to remap 
up one dot line. This should give us the best illusion of an apparently continuous 
motion. 

Our second hassle is called . . . 


Raster scan collisions 


You've seen this one before. It has ruined more than one animation attempt. 
There is “sugar,” or “collisions,” or “flicker,” or whatever in the display. Small 
objects may appear double or may momentarily reverse direction. These dis- 
tractions can range from just barely noticeable to downright annoying. 

On some personal computers, the worst of these distractions are caused by 
the CPU stealing time from the display for remapping. Fortunately, the Apple has 
a transparent display that never has to pause to let the microprocessor add bytes 
to, or remove bytes from, the display memory. Each and every machine cycle 
on the Apple gets shared 50-50 by the CPU and the display timing. Each works 
nicely in the other's unneeded and unused blind spot to gain full transparency. 

The main cause of sugar or collisions on an Apple display is that the television 
set paints a raster only one dot at a time. The top part of the raster goes down 
before the bottom part does. It takes 16 milliseconds to get from the top of the 
screen to the bottom, giving us some 262 horizontal lines of some 65 mi- 
croseconds each. 

What you can get during animation is a mix of the “old” picture and the 
“new” picture if you aren't careful. This can range from “just mapped” stuff to 
old information that is as much as 16 milliseconds out of date. This "old" and 
“new” mix can momentarily give you a "wrong" display. 

Fig. 7-3 shows us how we can get a collision between two character rows if 
we try moving characters and viewing them at the same time. Most of the time, 
you either are presenting "old" or “new” information. But, every once in a 
while, a character will get moved during the time it takes to get from one 
horizontal line to the next. When this happens on a blank line between charac- 
ters, the "new" or "dot line" character crashes into the "old" or "upper" dot line 
without any space between. The result is a brief flash that really can look bad. 

You can also get the opposite effect in which a dot line is dropped out. Instead 
of a flash, you get an “unflash” in which the middle of an "E," an “H,” an “S,” 
or whatever disappears momentarily, leaving you with a strange bunch of illegi- 
ble dots. 

This is sort of like a small town that has one cop and one thief, each of whom 
are making their rounds. Eventually, they are bound to run into each other even 
if they are traveling at different speeds and are using different paths going 
through town. 

All of which tells us we should never display the HIRES page you are moving 
characters to. While you can do a gentle scroll using a single page of video and 
remapping things one line at a time, you will find the collisions to be annoying 
and the motion slightly nervous or erratic. The “one-page” program that | tried 
turned out to be longer than the available space in one HRCG character set and 
this is a second disadvantage. You will get the best results by using two HIRES 
pages for a scroll, displaying one while you move dots to the new location on 
the other. 


Рога gentle scroll, both HIRE pages are used alternately to 
eliminate the "sugar," "sparkle," or “collisions” caused 
by raster scan problems. These effects usually last one 
field and can become very annoying. 


Most of the times, a HIRES map-while-displaying-the- 
same-page would look... 


As the raster scan works its way from top to bottom, it will 
overrun the mapping every now and then, leading to 
results... 


or perhaps even... 


Sugar and collision flashes can be completely eliminated 
by displaying one HIRES page while you are remapping to 
the second and, also, by switching between HIRES pages 
only during the vertical blanking time. 


Fig. 7-3. Raster scan collisions. 
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Even if you switch between the pages after mapping is complete, you can still 
get a brief flash or collision every now and then. This happens if you decide to 
switch between pages in the middle of a live scan. Our field sync hardware 


modification eliminates this final and fairly minor hassle. 


We use a program similar to the CRUDE program of Enhancement 4 to make 
sure we only flip display pages during the vertical blanking time. This way, only 
"whole" pages appear on the screen and you get no collisions. This particular 
use of field sync is far less critical than the exact locking needed for mixed fields 


or other super fancy stuff. 


To review, when the field sync modification is in place, we can do a simple 
bit test of SW3 that waits till it is “safe” to flip from one screen to the other. 
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The machine-language bit test of location $C060 sets the negative flag if it is safe 
to switch the pages and clears the negative flag if it is not. By BPL branching to 
retest till it is safe, you can always be sure that you will avoid all collisions and 
all sugar. 

What's that location in decimal for use т a BASIC program, you ask? You've 
got to be kidding. Your Apple warranty isn't long enough to let you do a gentle 
scroll in BASIC. In fact, unless you are really into machine language, even 
machine language will seem far too slow. So what you do is provide a special 
and exceptionally fast machine-language subroutine and call it from any host 
program in any language you like. 

This brings us to the third hassle of . . . 


Mapping time 


The real sticky problem is that it takes a long time to move all those dots from 
one HIRES page to a different position on the other one. Let's see. There are 192 
rows of 280 dots each for a total of 53,760 dots. We can move these dots seven 
at a time with a single machine-language byte, so only 7680 moves are needed. 
But wait. That is 7680 moves to go up a single dot row. We have to go eight 
dot rows to move up one full character—for a total of 61,440 mappings. 

Now, if you use machine language the way most people do, this remapping 
will take far too long. The usual way we might map is to use the indirect indexed 
command such as is done in the abrupt scroll included in the HRCG. The code 
could look something like this . . . 


REMAP LDA (P1LOC),Y ; Get a byte from page 1 
STA (P2LOC),Y ; Move it to page 2 
DEY ; Go to next byte 
BNE REMAP ; And repeat till done 


This says to go to the sum of the address in P1LOC plus the value in the Y regis- 
ter, and put whatever you get from there in the sum of the address in P2LOC plus 
Y. Both PILOC and P2LOC will be pairs of page Zero addresses that point to the 
base address at the left end on any line. Keep doing this remapping till Y hits 
zero. You start at the right end of one line and work your way to the left, remap- 
ping as you go along. The code is short, simple, very powerful, and disgustingly 
elegant. 

It also works, sort of. If you have the time. 

The trouble is that this obvious route is far too slow. Let's add things up. We'll 
assume an Apple machine cycle takes exactly 1 microsecond. If you are a timing 
purist, just multiply all that follows by 0.978. An indirect load takes 5 mic- 
roseconds. An indirect store takes 6. Add 2 microseconds to knock one count off 
Y, and a final 3 microseconds to go back and repeat. A total of 16 microseconds, 
or just a tad under 16 if you are really keeping score. 

Using 16 microseconds to move seven somethings sounds pretty snappy till 
you realize that we have 61,440 mappings to do. Multiplying 61,440 mappings 
times 16 microseconds per mapping equals 0.983 second. 

We can apparently scroll a row of characters smoothly up eight dots in slightly 
under a second. This doesn't sound too bad until you realize that there are 24 
lines of text on the screen, so it takes nearly 24 seconds to get from the bottom 
of the screen to the top. This can turn out to be unacceptably slow for some uses. 

What can we do to speed up a tight, sophisticated, and elegant little remap- 
ping loop like the one we just looked at? 

Scrap it. 
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That's right, scrap our compact and elegant code. Indirect indexed modes 
dramatically shorten the physical length of a program all right, but they take 
longer to execute. And loops a/ways add overhead, since you always have to 
decrement something and, then, branch to get out of a loop. Even an "empty" 
loop that does nothing uses up 5 microseconds per trip not doing whatever it is 
that it is not doing. 

The fastest possible code that you could write would use the fastest address 
mode and no loops. We could write a program that would absolutely load and, 
then, absolutely store each and every location and it would be much faster. 
“Brute force” coding of this type would only need 8 microseconds per mapping. 
Compare this to the 16 microseconds that the elegant code demands. 

But, this brute force route would have the disadvantage of needing more than 
46,000 bytes of code! And, that’s for a single mapping. You have to double that 
to get back to the first page. Some compromise is obviously needed between 
code that is short and elegant and code that is long enough to rapidly do the 
job. 

We first notice that absolute indexed addressing is fairly snappy at 4 mi- 
croseconds per load and 5 microseconds per store. And, we can now use a loop 
to shorten the code by bunches. But, there's that loop again. The sneaky and 
crucial trick is to share the loop as many ways as possible. If 32 mappings are 
done inside a loop, the loop overhead of 5 microseconds only takes 5/32 of a 
microsecond per mapping. Our code might look like this . . . 


REMAP LDA $2400,X ; move first byte 
STA $4000,X š 
LDA $2800,X ; move second byte 
STA $4400,X 
LDA $2C00,X ; Move third byte 
STA $4800,X 


| | i | | | ; (repeat 32 times) 


LDA $3F00,X ; move thirty-second byte 
STA $5B00,X 

DEX ; move one to left 

BNE REMAP ; and repeat till done 


This code is obviously much longer than the earlier code. But look at the 
timing. Four microseconds to load, five to store, and a mere 5/32 of a mi- 
crosecond as one mapping’s share of the loop overhead. Our total is slightly over 
nine microseconds, or around one-half the total of using the "elegant and 
compact” code of the HRCG. 

Note that this new code also maps in a different sequence. The usual code 
works from right to left, one horizontal dot row at a time. Our fast code starts 
with part of a rightmost column of dots and then works its way from right to left 
doing a partial column at a time. 

The actual mapping details turn out even messier than this, as we will see. The 
important points here are that an oddball mapping sequence (1) is very fast, and 
(2) doesn't matter anyway since you don't look at the page till after the mapping 
is completed. What we are after here is a fast final result, and that is just what 
we get. 
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The gentle scroll program turns out fairly long since we аге using less elegant 
addressing modes. The entire program is only 600 bytes long, and fits a protect- 
ed slot originally intended for use by an alternate character set under HRCG. 

When you use the gentle scroll, the measured time on screen is something like 
12 seconds from bottom to top. The first time you see this, you will say that it 
is far too slow. And, if you are listing a program, a gentle scroll may indeed take 
a minute to list a 100-line program. 

Let’s look at this 12 seconds in a different light. If we completely fill the screen, 
we'll average 7 words or so per line. And, 7 words per line times 24 lines equals 
168 words in 12 seconds, or a reading speed of 840 words per minute. 

This is at least four times faster than most people can read. When you actually 
use the gentle scroll in your programs, your messages will usually be short. What 
at first sounds like an awfully slow scroll time actually turns out to be a very 
useful and attractive speed. 

The fast remapping code will take 4 fields to scroll upwards by a single dot, 
which translates to 32 fields being required in order to do a complete 8-dot 
full-character scroll. Thus, slightly over half a second is needed for each full- 
character scrolling. 


MEMORY MAP 


А memory map of a 48K Apple II, using the gentle scroll under HRCC, is 
shown in Fig. 7-4. We've already seen back in Enhancement 3 how the bottom 
2K-bytes of RAM from $0000 through $07FF are reserved for system use. 
Review the details on this and you will find reference locations on page Zero 
of memory, the stack on page One, the keyboard buffer on page Two, DOS 
hooks on page Three, and "page One"' of text and low-resolution graphics on 
memory pages Four through Seven. Here a memory “page” consists of 256 
locations, while a video “page” is made up of whatever happens to fit the 
screen. One 1024-byte text or LORES page needs four RAM memory pages of 
256 bytes each. 

Looking further up the map, we see that HIRES page One fits in locations 
$2000 through $3FFF, and HIRES page Two resides at hex $4000 through 
$5FFF. Each HIRES page needs 8K of RAM to store its image. Thus, thirty-two 
pages of RAM memory will always be needed for each HIRES page. 

DOS normally resides at the top of RAM, and goes from locations $9600 up 
through $BFFF. The HRCG high-resolution character generator and its alternate 
character sets reside just under DOS. 

The HRCG is an example of a new type of program that uses an “R” disk file. 
The “R” stands for relocatable, and this coding must be handled differently from 
the usual "A," "B," "I," or "T" files you already know. When you use the 
LOADHRCG program off the DOS Toolkit, the HRCG is automatically put just 
below DOS and, then, enough space is cleared below HRCG for as many 
alternate fonts as are needed. After enough room is set aside and the fonts are 
loaded, the Applesoft HIMEM pointer is then automatically moved down. This 
will protect the HRCG and any of the alternate character sets from intrusion. 

This nicely eliminates the problem of making room for machine-language 
sequences with Applesoft. Just put your sequence in the space intended for the 
highest HRCG alternate character set, and the routine gets put out of harm's 
way. Everything is set aside for you automatically without any calculations or 
sneaky tricks. 

You'll find two areas left in the memory map for your Applesoft or other 
program. The 6K space from $800 through $2000 is available, as are the 10K + 
locations $6000 through $8AFE. 
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HEX DECIMAL 
ЗВЕЕЕ 49151 


38400 
наса a 36352 | GENTLE SCROLL SUBROUTINE, 
35584 2 PROTECTED UNDER HRCG 


10K+ SPACE AVAILABLE 
FOR APPLESOFT STRINGS 
AND VARIABLES 


24576 


16384 


$2000 8192 
6K SPACE AVAILABLE 
FOR APPLESOFT 
PROGRAM LINES 

$0800 2048 

$0000 0 


Fig. 7-4. Memory map of 48K RAM under gentle scroll. Most shorter Applesoft 
programs will fit as is. Longer ones may need pointer adjustment, 
disk reaccess, RAM card use or other memory management. 


Applesoft normally builds its program up from its TXTAB pointer at the lowest 
available RAM location. This is usually $0800. It also builds its variables down 
from HIMEM. You will usually have around 6K of program space and some 10K 
of variable space available till you bump into either HIRES page. 

Most shorter Applesoft programs will fit as is. Longer ones may need pointer 
adjustment, disk reaccess, REM elimination, or other memory management 
tricks. Note that this is nearly the same problem that you have any time you want 
to use both HIRES pages and Applesoft. The HRCG and its alternate fonts take 
up little extra room. 

Our gentle scroll program should get loaded as the Ajghest character set under 
the HRCG. But, we will never use this set as a character set. Instead, we will 
find the magic hooks to jump to this code subroutine every time the HRCG 
wants to do a scroll. The reason we use a character set location is for the 
convenience it gives us in automatically loading a machine-language program 
into a protected space. On a 48K Apple computer operating under DOS 3.3, 
the highest character set lies from $8AFF through $8CFE. If you do use any 
alternate character sets, they will automatically be placed lower in memory. 
Regardless of how many alternate fonts you use, the highest character set will 
always start at $8AFF. Should you use alternate character sets, each additional 
character set will need another 3 pages, working down through memory. 

Thus, the highest alternate font will always lie from $8AFF to $8DFF, and the 
lowest alternate font will always have the lowest starting address, regardless of 
how many fonts you use. All of these will reside in a protected space above 
HIMEM. 
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We now know where to put our gentle scroll machine-language program and 
how to get it there. One big location problem that remains is figuring out what 
maps where on HIRES page One and page Two. 

The first time you look at HIRES locations, they may seem random or sense- 
less. In fact, they were very carefully chosen to greatly simplify the hardware 
needed in the Apple’s video timing circuitry. 

Fig. 7-5 shows us a typical HIRES horizontal line. Each line begins with a BASE 
address on the left and needs 40 bytes. The bytes are numbered left to right as 
BASE + 0, BASE + 1, BASE + 2,..., and so on, up through BASE + 39 in deci- 
mal, or BASE + $27 in hex, at the extreme right. 

Each byte, іп turn, holds seven dots. These dots are arranged “backwards” 
as the lower seven bits. The LSB is the /eftmost dot. The eighth or MSB is not 
mapped. Instead, it is used as an optional half-dot shifter that gives us color 
changes by shifting all seven dots simultaneously. 

As an example, if some line has a base address of $2400, the leftmost seven 
dots will be in location $2400, the next seven in $2401, the next seven in $2402, 
and so on across the line to the final seven dots contained in $2427. 

What gets sticky fast is finding the base address for each horizontal line. There 
are elegant program sequences in the HIRES subroutines that let you calculate 
each and every base address as needed. But these calculations take quite a bit 
of time and they must be avoided at all costs if you want the fastest possible 
code. 

Rather than calculate base addresses, we will simply call them out as they are 
needed in the code. This is much faster. Table 7-1 is a table of the base addresses 
of each line. This is shown as a decimal or hex scan line number and as a 
“which-dot-row-of-which-character” number pair. 

The base addresses are rearranged for you in Fig. 7-6. Here we see the packing 
of lines into each sequential 256-byte page of memory. These addresses are all 
shown for HIRES page One on the left and HIRES page Two on the right. To find 
a comparable address for Hires page Two, just add hex $2000 to each page One 
location. To go the other way, subtract hex $2000. 

Now, if we were trying to display and remap on the same page at the same 
time, we would have to start at the top of the display and remap each line one 
place up from where it happened to be. This would take 192 separate remap- 
pings since there are 192 vertical lines (24 characters Х 8 dots per character) 


LEFTMOST BYTE ОМ BASE ADDRESS BASE ADDRESS RIGHTMOST BYTE ON 
THE LINE IS THE PLUS ONE PLUS TWO THE LINE IS THE 
BASE ADDRESS BASE ADDRESS PLUS 


DECIMAL 39 OR HEX $27 


БЕ БИ (арыға | ЗО НС 1 
EACH HIRES BYTE HOLDS 
SEVEN DOTS, ARRANGED 
“BACKWARDS” IN THE 


DATA WORD. . . 
THERE ARE 40 BYTES RIGHTMOST LEFTMOST 
DOT DOT 


OF 7 DOTS EACH USED 
FOR EACH HORIZONTAL 
ROW OF 280 DOTS т 


ТНЕНЕ АНЕ 192 НІНЕ5 
LINES PER PAGE. EACH 
LINE HAS ITS OWN BASE 
ADDRESS 


EIGHTH BIT CONTROLS SHIFT OF ALL 7 DOTS 
% DOT TO THE RIGHT FOR COLOR CHANGE 


Fig. 7-5. Details of one horizontal line mapping. 
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$2000 
$2100 
$2200 
$2300 
$2400 
$2500 
$2600 
$2700 


$2800 
$2900 
$2A00 
$2B00 
$2000 
$2D00 
$2E00 
$2F00 


PAGE 
TWO 


PAGE 
ONE 


$3000 
$3100 
$3200 
$3300 
$3400 
$3500 
$3600 
$3700 


$3800 
$3900 
$3A00 
$3800 
$3000 
$3000 
$3E00 
$3F00 


| I [ | [ ] ) 
$00 $28 $50 $80 %А8 500 $FF 


EACH BLOCK SHOWS HORIZONTAL LINE NUMBER 
IN DECIMAL. B= UNUSED 8 BYTES ОҒ RAM. 


Fig. 7-6. How HIRES lines are packed into memory. 


in the display. We would map line 1 to line 0, then line 2 to line 1, and so on 
down the screen. 

But, a two-page mapping lets us get sneaky and greatly shorten the code. An 
indexed move lets us move up to 256 bytes from one base address. Do things 
just right and we can be remapping six lines using the same indexed move 
instruction. This shortens the code bunches. For instance, one indexed mapping 
code pair can map lines 1 to 0, 65 to 64, 129 to 128, 9 to 8, 73 to 72, and 137 
to 136. All of this is done with the same base address of hex $2400. You first 
set your X index pointer to $F7 and work your way down the list. First, you 
remap all of line 137, then all of те 73, then all of line 9. Then, you reset your 
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Table 7-1. HIRES BASE ADDRESSES 


LINE NUMBER PAGE 1 BASE PAGE 2 BASE 
DECIMAL CHAR/DOT HEX DECIMAL HEX DECIMAL HEX 


0 
1 
2 
3 
4 
5 
6 
7 
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_—є————-—————————Юї3—— 
акт  _ до 


Table 7-1 Cont. HIRES BASE ADDRESSES 


PAGE 1 BASE PAGE 2 BASE 
HEX DECIMAL HEX 


LINE NUMBER 
DECIMAL CHAR/DOT HEX DECIMAL 
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HIRES BASE ADDRESSES 


PAGE 2 BASE 
DECIMAL HEX 


Table 7-1 Cont. 


LINE NUMBER PAGE 1 BASE 
DECIMAL CHAR/DOT HEX DECIMAL НЕХ 
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Table 7-1 Cont. HIRES BASE ADDRESSES 


LINE NUMBER PAGE 1 BASE PAGE 2 BASE 
DECIMAL CHAR/DOT HEX DECIMAL HEX DECIMAL HEX 


X index to hex $77 and work down all of line 129, followed by all of line 65 
and, finally, all of line 1. Trace this action out on Fig. 7-6 to make sure you see 
and understand exactly what is happening. 

However, remapping several lines with the same code does give you several 
minor hassles that you have to get around. Those unused locations from $78 
through $7F and $F8 through $FF on any page must be bypassed during the 
mapping. Besides making the code take longer, a glitch or two will remain on 
the screen if you do not carefully bypass all unused locations. 

As an aside, note that these unused locations are usually plowed anytime you 
clear the HIRES screen. Thus, while these “free” locations are just sitting there, 
you can’t safely use them for anything. This is in contrast to the 64 bytes hidden 
on the page 1 text and LORES1 screen which are used for I/O and are very 
carefully protected during a screen clear. 

There are also a few lines that do not remap exactly in the way you might 
expect them to. These lines must each be “custom” mapped because they cause 
a move from column to column in Fig. 7-6. Five of the special cases are 64 to 
63, 128 to 127, 8 to 7, 72 to 71, and 136 to 135. There is a sixth special case 
of 0 to nowhere, but since nowhere is off screen, we can ignore this mapping. 
Again, check into Fig. 7-6 to find out why these five mappings are special. 


PROGRAM AND FLOWCHART 


A flowchart of the gentle scroll program is shown in Fig. 7-7, while Program 
7-1 gives you an assembler listing of the GENTLE SCROLL.SET program. Fig. 7-8 
shows a hex dump of the GENTLE SCROLL.SET. Details for copying and using 
the GENTLE SCROLL.SET program follow: 
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( сат _ 
INITIALIZE — о OPTIONAL 
ANDSETUP | LocK TO 
DISPLAY 1 | lI Z | SWITCH TO 
MaPTo2 Ш | PAGE1 
DISPLAY2 ff 
| MAPTO1 | 


ООМЕ 
8 MAPPINGS 
? - 


E Бе | ВЕМАР 
RESTORE а SPECIAL 
е совр а ШМЕ5 


Fig. 7-7. Flowchart of GENTLE SCROLL.SET. Machine-language subroutine is called 
whenever an 8-dot gentle scroll of HIRES page 1 is wanted. 


We begin by saving all registers and, then, going to SYNC subroutine that 
optionally waits for the vertical blanking time before continuing. Page One is 
then displayed. We then remap most of the lines on page One onto page Two, 
moving each line up one dot row. We start at the right of the screen and make 
our way rapidly down and slowly to the left. This oddball scheme lets us share 
our loop timing 31 ways and it doesn't matter anyway since we aren't looking 
at what we are mapping till we are finished. 

Unused locations $F8 through $FF are never mapped. We ignore these by 
beginning with an index value of $F7 and working down. Unused locations $78 
through $7F are bypassed with a compare and fix. Should we get to an index 
value of $7F, this value is immediately changed to $77, thus bypassing these 
unused locations. 

The bulk of the mapping is done six lines at a time, handling a total of 31 Х 
6 — 186 lines. 

After the bulk of the mapping is complete, we then custom handle the five 
special cases. These get remapped individually. 
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PROGRAM 7-1 
GENTLE SCROLL SET 


LANGUAGE: APPLE ASSEMBLER NEEDS: HIRES SUPPORT PROGRAM 
SUCH AS HRCG. 
HIMEM < 35583 


* * k k k k k k k k k 1 k КО k k * k ОЖ + 


GENTLE 
SCROLL.SET 


VERSION 3.1 
( 3-18-81) 


COPYRIGHT 1981 


BY DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


. 
4 
. 
4 
. 
, 
. 
, 
. 
4 
. 
П 
” 
7 
. 
, 
е 
t 
. 
4 
е 
И 
. 
, 
? 
, 
е 
, 
е 
4 
е 
, 
. 
4 


ххх Fee et 3 HF HF HF * 
+ t+ + ЖЕЛЕ ДЕЛЕ ин FF а + 


* k k *k k k * k k k k k k k k k k k *[* 


THIS PROGRAM CREATES A PAGE 
ONE GENTLE SCROLL UNDER HRCG 
FOR USE ON 48K APPLE II. 


IT LOADS AS THE HIGHEST CHARACTER 
SET AND USES HIRES PAGE TWO 
FOR A WORKSPACE. 


A VSYNC HARDWARE MOD CONNECTING 
4/C14 TO 4/H14 IS RECOMMENDED 
FOR BEST ОРЕКАТТОН. 


IF YOU ARE NOT USING HRCG -- 


A MACHINE JSR $8AFF -OR- 

AN INTEGER CALL -29953 -ОК- 
AN APPLESOFT CALL 35583 
GIVES YOU AN EIGHT SCAN LINE 
GENTLE SCROLL ON HIRES 1 


^e < 99 ме ~e 


PROTECT THIS SPACE WITH 
AN APPLESOFT HIMEM:35582. 


^» se 
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PROGRAM 7-1, CONT'D... 


ЗАРЕ: 
ВАЕЕ: 


ЗАЕЕ: 
ВАЕЕ: 


BAFF: 
8AFF: 


8AFF: 
S8AFF: 


ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 


se ` ` 9. 


we `. 


` `. 


~e 9» x ` 


IF YOU ARE USING HRCG 
MACHINE LANGUAGE -- 


GENTLE SCROLL ОМ -- 
GENTLE SCROLL OFF - 


IF YOU ARE USING HRCG 
АРРЬЕЗОЕТ -- 


GENTLE SCROLL ОМ -- 
AND -- 


GENTLE SCROLL OFF - 

AND -- 
POKE ONLY AT TOP 
OF SCREEN! 


AND 

$9214: 00 8B 
$9214: 21 92 
АКО 

РОКЕ 37396,0 
РОКЕ 37397,139 


РОКЕ 37396,33 
РОКЕ 37397,146 
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PROGRAM 7-1, CONT’D... 


BAFF: **** HOOKS **** 


FF3F: IOREST EQU С5ҒЕЗЕ 
ЕЕ4А: IOSAVE EQU SFF4A 
с054: PAGEL] EQU 8с054 
C055: PAGE2 EQU $С055 
C060: VSYNC EQU 8с060 ; 4/C14 VIA 4/Н14 SYNC MOD 


BAFF: ****** MAIN PROGRAM %%%%%% 


BAFF:EA NOP ADJUST RELOCATE START 
8B00:20 JSR IOSAVE SAVE ALL REGISTERS 


8B03:A0 LDY #$04 FOR FOUR PAIRS OF MAPPINGS 


8B05: 20 JSR SYNC OPTIONAL LOCK TO VBLANK 
8B08:8E STX РАСЕ1 DISPLAY PAGE ONE 


8BOB:A2 LDX #8Е7 BYPASS UNMAPPED BITS 
8BOD:BD LDA $2400,X LINES 1-65-129-9-... 
8B10:9D STA $4000,X 
8B13:BD LDA $2800,X 
8B16:9D STA $4400,X 
8B19:BD LDA $2C00,X 
8B1C:9D STA $4800,X 
8BlF:BD LDA $3000,X 
8B22:9D STA $4C00,X 
8B25:BD LDA $3400,X 
8B28:9D STA $5000,X 
8B2B:BD LDA $3800,X 
8B2E:9D STA $5400,X 
8B31:BD LDA 53С00,Х 
8B34:9D STA $5800,X 


8B37:BD LDA 52100,Х : LINES 16-80-144-24-... 
8B3A:9D STA 55С80,Х 
8B3D:BD LDA $2500,X 
8B40:9D STA $4100,X 
8B43:BD LDA $2900,X 
8B46:9D STA $4500,X 
8B49: BD LDA $2D00,X 
8B4C:9D STA $4900,X 
SB4F:BD LDA $3100,X 
8B52:9D STA $4D00,X 
8B55:BD LDA $3500,X 
8B58:9D STA $5100,X 
8B5B:BD LDA $3900,X 
8B5E:9D $5500,X 
8B61:BD $3D00,X 
8B64:9D $5900,X 
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PROGRAM 7-1, CONT’D... 


8B67:BD 00 115 $2200,X ; LINES 32-96-160-40-... 
8B6A:9D 80 116 $5D80,X 
8B6D:BD OO 117 $2600,X 
8B70:9D 00 118 $4200,X 
8B73:BD OO 119 $2A00,X 
8B76:9D OO 120 $4600,X 
8B79:BD OO 121 52Е00,Х 
8B7C:9D 00 122 54А00,Х 
8B7F:BD 00 123 53200,Х 
8в82:90 00 124 54Е00,Х 
8B85:BD 00 125 53600,Х 
8B88:9D 00 126 55200,Х 
8B8B:BD 00 127 $3A00,X 
8B8E:9D OO 128 $5600,X 
8B91:BD OO 129 $3E00,X 
8B94:9D 00 130 $5A00,X 


8B97:BD 00 132 52300,Х + LINES 48-112-176-56-... 
8B9A:9D 80 133 $5E80,X 
8B9D:BD 00 134 $2700,X 
8BAO:9D 00 135 $4300,X 
8BA3:BD OO 136 $2B00,X 
8BA6:9D 00 137 $4700,X 
8BA9:BD OO 138 52Ғ00,Х 
8BAC;9D OO 139 $4B00,X 
8BAF:BD OO 140 $3300,X 
8BB2:9D 00 141 64Ғ00,Х 
8BB5:BD 00 142 53700,Х 
8BB8:9D 00 143 55300,Х 
вввв: во 00 $3B00,X 
8BBE:9D 00 $5700,X 
8BC1:BD 00 $3F00,X 
8BC4:9D 00 $5B00,X 


8BC7:CA ONE MORE ROW? 

8BC8: EO #$7Е BYPASS UNUSED LOCATIONS? 
8BCA:DO МОЕТХ 

8BCC:A2 #$77 

BBCE:EO NOFIX #SFF 

8BDO:FO ROWDUN 

8BD2:4C NXODD 

8BD5:A2 ROWDUN #$27 HANDLE SPECIAL MAPPINGS 
8BD7:BD ODDTHD 52080,Х 8 ТО7 

8BDA:9D 55С00,Х 

8BDD:BD 52028,Х ; 64 ТО 63 

8BEO:9D $5F80,X 

8BE3:BD $20A8,X 72 TO 71 

8BE6:9D 55С28,Х 

8BE9:BD $2050,X 128 TO 127 

8BEC :9D ЗБЕАВ,Х 

ВВЕР : BD $20D0,X 136 TO 


PROGRAM 7-1, CONT’D... 


8BF2:9D 
8BF5:A9 
8BF7:9D 
8BFA:9D 
8BFD:CA 
8BFE:10 


8C00: 20 
8C03:8E 


8С06: 


8C06:A2 
8C08:BD 
8COB:9D 
8COE: BD 
8C11:9D 
8C14:BD 
8C17:9D 
8C1A:BD 
8C1D:9D 
8C20:BD 
8C23:9D 
8C26:BD 
8C29:9D 
8C2C:BD 
8C2F:9D 


8C32:BD 
8C35:9D 
8C38:BD 
8C3B:9D 
BC3E: BD 
8C41:9D 
8C44: BD 
8C47:9D 
8C4A: ВО 
BCAD:9D 
8C50:BD 
8C53:9D 
8C56:BD 
8C59:9D 
8C5C:BD 
8C5F:9D 


50 
00 
DO 
DO 


D7 


09 
55 


5С 


ЗЕ 
БЕ 


167 
168 
169 
170 
171 
172 


174 
175 


177 


179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 


195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 


*** START 


LDX 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 


LDA 
STA 
LDA 
STA 
LDA 
STA 


$5C50,X 
#00 

$3FDO,X 
$5FDO,X 


ODDTHD 


SYNC 
PAGE2 
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ERASE BOTTOM LINES 
OF PAGE ONE 
OF PAGE TWO 


OPTIONAL LOCK TO VBLANK 
SWITCH TO PAGE TWO 


REMAP BACK TO PAGE ONE 


#8Е7 

54400,Х 
52000,Х 
54800,Х 
52400,Х 
54с00,Х 
52800,Х 
55000,Х 
52С00,Х 
55400,Х 
53000,Х 
55800,Х 
53400,Х 
55С00,Х 
53800,Х 


54100,Х 
$3C80,X 
$4500,X 
$2100,X 
$4900,X 
$2500,X 
$4D00,X 
$2900,X 
$5100,X 
$2D00,X 
$5500,X 
$3100,X 
$5900,X 
$3500,X 
55р00,Х 
53900,Х 


. 
4 


BYPASS UNMAPPED BITS 
LINES 1-65-129-9-... 


LINES 16-80-144-24-... 


197 
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PROGRAM 7-1, CONT’D... 


8C62:BD 
8C65:9D 
8C68: BD 
8C6B:9D 
8C6E:BD 
8C71:9D 
8C74:BD 
8C77:9D 
8C7A:BD 
8C7D:9D 
8C80:BD 
8C83;9D 
8C86: BD 
8C89:9D 
8С8С: во 
8C8F :9D 


8C92:BD 
8C95:9D 
8C98:BD 
8C9B:9D 
8C9E:BD 
8CA1 :90 
8CA4:BD 
8CA7:9D 
8CAA:BD 
8CAD:9D 
8CBO:BD 
8CB3 :9D 
8CB6:BD 
8CB9 :9D 
8CBC:BD 
8CBF:9D 


00 
80 


42 
3D 


212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 


229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 


$4200,X 
$3D80,X 
$4600,X 
$2200,X 
$4A00,X 
$2600,X 
54Е00,Х 
52А00,Х 
55200,Х 
52Е00,Х 
55600,Х 
53200,Х 
55А00,Х 
53600,Х 
$5E00,X 
$3A00,X 


$4300,X 
$3E80,X 
$4700,X 
52300,Х 
54в00,Х 
52700,Х 
54Ғ00,Х 
52В00,Х 
55300,Х 
$2F00,X 
$5700,X 
$3300,X 
$5B00,X 
$3700,X 
$5F00,X 
$3B00,X 


+ 
4 


. 
4 


LINES 32-96-160-40-... 


LINES 48-112-176-56-... 


PROGRAM 7-1, CONT’D... 


8СС2:СА 
8ССЗ:ЕО 
8CC5:DO 
8CC7:A2 
8CC9:EO 
8CCB:FO 
8CCD:4C 


8СрО:А2 
8CD2:BD 
8CD5:9D 
8CD8: BD 
8CDB:9D 
8CDE:BD 
8CE1:9D 
8CE4: BD 
8CE7:9D 
8CEA: BD 
8CED:9D 
8CFO:BD 
8CF3:9D 
8СЕ6:СА 
8СЕ7:10 


8СҒ9: 


8СЕ9:88 
8CFA:FO 
8СЕС:4С 
8СЕЕ:20 
8002 :8с 
8005:20 
8008:60 


8209: 


8D09:2C 


8D0C:10 
8DOE:60 


60 
FB 


246 
247 
248 
249 
250 
251 
252 


254 ROWDUM 


255 EVNT 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 


270 ; 


272 
273 
274 
275 DONE 
276 
277 
278 


280 ; 


282 SYNC 
283 


HD 


$$7F 
NOF1X 
#877 
#$ЕЕ 
ROWDUM 
GOEVN 


#$27 

$4080,X 
$3c00,X 
54028,Х 
$3F80,X 
$40A8,X 
$3C28,X 
$4050,X 
$3FA8,X 
$40D0,X 
$3C50,X 
S5FDO,X 
$3FDO,X 


EVNTHD 
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BYPASS UNUSED LOCATIONS? 


HANDLE SPECIAL MAPPINGS 
8 TO 7 


64 TO 63 
72 TO 71 
128 TO 127 
136 TO 135 


RECOPY BOTTOM LINE 


**** START REMAP BACK TO ONE **** 


DEY 
ВЕО 
JMP 
JSR 
STY 
JSR 
RTS 


DONE 
GOODD 
SYNC 
PAGE] 
IOREST 


~e чо se ~o 


NEXT SCREEN PAIR? 


OPTIONAL LOCK TO VBLANK 
SWITCH TO PAGE ONE 
RESTORE ALL REGISTERS 
AND RETURN 


**** VSYNC SUBROUTINE **** 


BIT 
BPL 


284 NOSYNC RTS 


VSYNC 
SYNC 


*** SUCCESSFUL ASSEMBLY: NO ERRORS 


. 
г 
е 
? 


ТЕ5Т РОВ УВЬАМК 
АКО МАТТ РОВ УВГАМК 
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GENTLE SCROLL 


Fig. 7-8. Hex dump of GENTLE 
SCROLL.SET. 


А final detail finishes the mapping from page One to page Two. We clear the 
bottom line of both page One and page Two. If you don't do this, the descenders 
of lower-case characters will elongate and look very strange. 

When the mapping is completed, we jump to the optional SYNC subroutine 
and, then, flip the switch to page Two. 

The whole remapping process is then repeated, only this time we display page 
Two and remap back to page One. A dot initially on page One gets mapped one 
dot higher onto page Two and, then, gets remapped two dots up from where 
it started back on page One. 

Eight remappings are done in four groups of two each. We end up back on 
page One with all the characters moved up exactly one dot row. 


USE HINTS ` 


Normally, you will save your program as a GENTLE SCROLL.SET on a disk 
containing the HRCG and LOADHRCG programs. When asked for the number 
of alternate character sets, answer one more than what you intend to use, and 
enter the GENTLE SCROLL.SET as your last alternate character font to be loaded. 
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A ready-to-go copy of the machine-lan- 
guage object code (GENTLE 
SCROLL.SET) is provided on the com- 
panion disk to this volume. The Apple 
HRCG will automatically load the object 
code when it is entered by name as the 
highest alternate character set. 

Should you want to copy this program 
“Бу hand," do the following: 

. Boot a DOS 3.3 disk that has room 
on it for the GENTLE SCROLL.SET. 

. Get into the monitor by doing a 
CALL —151 «cr». 

. Enter the hex dump code of Fig. 
7-8. To do this, type 8AFF : EA 
«cr». Then, type : 20 4A FF АО 
04 20 07 8D «cr». Continue this 
process of entering a colon, 
followed by eight op code bytes 
anda «cr» till you have entered 
all the code. 

. Type 8AFF L «cr» and verify the 
code by comparing it against 
Program 7-1. Retype L «cr» as 
often as needed to go all the way 
through the program. 

. Restore DOS by using 3DOG 
«cr». 

. Type BSAVE GENTLE SCROLL.SET, 
A$8AFF, L$210. This should save 
your program to disk. 

. To use your gentle scroll, do а 
BLOAD GENTLE SCROLLSET ` 
«cr» as needed. If you are NOT 
using HRCG, note that (1) you must 
protect the space 8AFF-8DOC, (2) 
you must be displaying text on 
HIRES page One, and (3) a CALL 
35583, a CALL —29953, or a JSR 
8AFF will move everything up eight 
dots and, then, return to your main 
program. 


To activate your gentle scroll set, you have to go into the HRCG and find the 
subroutine call to its own abrupt scroll program. In machine language, use 
$9214: 00 8B to use the gentle scroll and use $9214: 21 92 to use the abrupt 
scroll. Equivalent Applesoft locations appear in Program 7-1. 

These locations assume that you are using the same version HRCG that | am 
on a 48K Apple microcomputer. The hooks may change with a change in HRCG 
version or a change of program. What you do is reach into the host program 
and find that program's own call to its own abrupt scroll and, then, substitute 
the gentle scroll subroutine's starting address when it is wanted. There are more 
details on this in Enhancement 3. 

Note that the GENTLE SCROLL.SET is not relocatable as is. It will only work 
with a starting address of either $8AFF ог 58800. There are three absolute jumps 
needed that are beyond the range of a relative branch, and there are absolute 
calls to the SYNC subroutine. 
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Should you want to use the gentle scroll with some other HIRES character 
generator as host, just find the equivalent scroll hooks and use them. If you want 
to test the gentle scroll without a character-generator program, make sure you 
are displaying HIRES page One and do a JSR to $8B00, a CALL 35583, ora CALL 
— 29953. This should move everything up one character row for you and then 
return you to your host program. 

Program 7-2 is an Applesoft demo called GENTLE SCROLL TESTER. You can 
use this one without any HIRES character generator. The program puts a lower- 
case message on the screen, and slowly scrolls it up for you. The process repeats 
over and over again until you press any key. 

Once again, all that the GENTLE SCROLL.SET can do for you is move existing 
HIRES characters or graphics up the screen. It cannot put anything new on the 
screen. For best effects, you will have to use HRCG or something similar to first 
enter your HIRES screen message. 

If you do not have the field sync mod т place, change $8009 to $60 in 
Program 7-1. Otherwise, your gentle scroll may hang. 

And, again repeating, you will get the smoothest results if you have the 
hardware field sync modification of Enhancement 4 in place. 

Naturally, the gentle scroll will only work when a HIRES page is being dis- 
played. Should you drop back to a conventional LORES/text page, the gentle 
scroll will no longer work. A system RESET will sometimes drop you out of a 
HIRES character-generator program. To restore your gentle scroll, reactivate the 
HIRES display mode, and verify that the scroll hooks are still intact. 

Two gotchas. If you are using Applesoft POKES to connect the GENTLE 
SCROLL.SET to HRCG, make absolutely sure you do it at the top of a screen. 
If you try this at the bottom of the screen, the first POKE sets up a scrolling 
address that is only “опе Най” correct, and the next scroll attempt bombs the 
program. And, never enter text while a gentle scroll is taking place as keys will 
be ignored for the time it takes to complete the scrolling. You can beat this with 
an add-on key buffer, but it is simpler to arrange your programs so as to never 
call for or accept a key input until after the display is stable. 


Like 50.... 
TWO USE RULES 


Т. If you are using Applesoft 
POKE commands to connect 
your GENTLE SCROLL.SET, do 
so only at the TOP of the 
screen! 


2. Do not call for or allow any 
text input while the gentle 
scrolling is actually taking 

place. 


If your scroll seems slightly erratic, check first to make sure that the hardware 
field sync mod is in place and that Program 7-1 is hooked into it. It also pays 
to have the fastest possible entry of characters on the screen, since the gentle 
scroll has to take time out to let the HRCG, or whatever else you use, put each 
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PROGRAM 7-2 
GENTLE SCROLL TESTER 


LANGUAGE: APPLESOFT NEEDS: GENTLE SCROLL SET 
FIELD SYNC MOD 
(OPTIONAL) 


* * * * * * k k k k k * * k k k k k *k k Ñ 


GENTLE SCROLL 
ТЕ5ТЕК 


VERSION 1.0 
(9-28-81) 


COPYRIGHT 1981 
ВУ DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


X* X tt ++ +*+ ххх 


ж 
ж 
ж 
ж 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


k k k k k k k k k k K k k k k k k * * 


THIS PROGRAM TESTS AND 
DEMONSTRATES THE GENTLE 
SCROLL OF ENHANCEMENT 7 
FOUND IN ENHANCING YOUR 
APPLE II, VOLUME I. 


THE SUBROUTINE "GENTLE 
SCROLL.SET" IS NEEDED. 


THE FIELD SYNC MOD 
OF ENHANCEMENT #4 IS 
NOT NEEDED, BUT WILL 
GIVE A MUCH SMOOTHER 
SCROLLING ACTION. 


FOR BEST EFFECTS, 

USE THE GENTLE SCROLL 
WITH A HIRES CHARACTER 
GENERATOR SUCH AS 

HRCG OR HIGHER TEXT 
INSTEAD OF THIS PROGRAM. 


100 TEXT : HOME : УТАВ 20: PRINT 
"HELLO! Т AM YOUR ...." 
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PROGRAM 7.2, CONT’D... 


HIMEM: 35500: REM PROTECT 
GENTLE SCROLL SET SPACE 
PRINT "BLOAD GENTLE SCROLL.S 
ET": REM CTRL D 


HGR : РОКЕ - 16302,0: CALL 
- 1998: REM FULL HIRES SCR 
EEN 
HCOLOR= 3 
H = 100:V = 184: REM SET TE 
XT START 


GOSUB 2000 
FOR N = 1 TO 1000: NEXT N: CALL 
35583: REM "GENTLE" 

Н = 100: GOSUB 2000 
FOR М = 1 TO 1000: NEXT М: CALL 
35583: REM "SCROLL" 

Н = 100: GOSUB 2000: REM "ТЕ 
STER" 


FOR N 1 TO 3000: NEXT N 
FOR N 1 TO 9: CALL 35583: NEXT 
N 
FOR N 1 TO 3000: NEXT N 
IF РЕЕК (49152) > 127 THEN 
POKE 49168,0: PRINT : PRINT 
"RUN MENU" 
REM DELETE 267 IF AUTO MENU 
IS NOT IN USE. 


IF РЕЕК (49152) > 127 THEN 
POKE 49168,0: TEXT : HOME : 
PRINT "PARTING IS SUCH SWEE 

T SORROW": VTAB 22: END 

CLEAR : HIMEM: 35582: GOTO 2 

20: REM GO ROUND AGAIN IF N 

O KEY HAS BEEN PRESSED 


REM CHARACTERS C,E,G,L,N,O 
,R,S,T FOLLOW IN ORDER 


HPLOT H + 4,V + 2 TO H + 1 

HPLOT H,V + 3 TO H,V 

HPLOT H + l,V + 6 TOH + 
‚У + 6: RETURN 

HPLOT H,V + 4 TO H + 4,V + 


? 


Р 
т 
У 
У 
у 
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PROGRAM 7-2, CONT’D... 


+ 2: 


У 
4: 
4,V + 5: HPLOT 
H 
7 


"m 
го 


< g + + + 93 + 9 + 99 + 


OT H + 1,V TO H 

2,V + 6: HPLOT H + 

+ 6: RETURN 

6 TO H,V + 2 TO 
HPLOT H + 4,V + 

6: RETURN 

TO H,V + 5: HPLOT 


mmm om om 
m m 

t: го 

о 

<<< 

+ + + 


з 
o 


с 
Я + + N +< 


Оръгюою+оОньвно 
=. 
ыч > 
m << jati m < + m 3 = 


+ 
P 
+ 
+ 
+ 
+ 
P 


г 
5 
зоәммошошаосемоОООоОо- 
осо 
к-н 
Ош 
> OV 


FOR М = 1 ТО 6: GOSUB 3000: 
H = + 8: NEXT №: RETURN : REM 
PUIT DOWN SIX LETTERS 


READ CHARACTER: ON CHARACTE 
R GOSUB 1010,1020,1030,1040, 
1050,1060,1070,1080,1090 

RETURN : REM FIND LETTER С 
ODES 


DATA 3,2,5,9,4,2,8,1,7,6,4, 
4,9,2,8,9,2,7: REM SAYS "GE 
NTLE/SCROLL/TESTER" 
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line of characters on the screen. If you make each character line the same length 
and put them on the screen with fast machine-language code, you will get the 
smoothest results. 

Funny things may happen if you try to use GENTLE SCROLL.SET on a colored 
background; particularly, if it's an “illegal” color. To handle colored back- 
grounds, you will have to suitably modify the “clear both bottom lines” code 
into something that handles each color byte individually. One alternative is to 
simply copy the bottom line of page One to the bottom line of page Two. This 
gives you color but introduces a lower-case elongating descender bug. 

To try this color background alternative, replace GENTLE SCROLL.SET 8BF5: 
A9 00 9D 00 3F with 8BF5: BD DO 3F EA EA. 

Once your gentle scroll is working, you should be able to think up all sorts 
of new possibilities. How would you handle the terrain flyby in a bomber 
mission or a road in a road race? How about dice, roulette wheels, or menu 
selectors that rotate? What about several things that are moving at once? Note 
that partial screen gentle scrolls can run much faster than whole screen ones. 
Note also that for graphics use, you might be able to jump two or more scan 
lines at a time, rather than just one % 


The programs GENTLE SCROLL.SET, 
GENTLE SCROLL.SET. SOURCE, and 
GENTLE SCROLL TESTER are included 
on the companion diskette to this 
volume. 


АП are fully copyable. 


Епһапсетепі 


FAST BACKGROUNDER 


A HIRES utility that gives you any 
of 191 solid background colors or 
18,446,744,073,709,551,616 ра!- 
terns. It runs seven times faster 
than you might expect and it is 
easily made glitchless. 


FAST BACKGROUNDER 


There is a convenient and useful HIRES screen clear subroutine that is avail- 
able as part of your Apple’s firmware. This code is provided both in the Ap- 
plesoft ROMs and in the Programmer's Aide that comes with the Integer ROMs. 
The background clearing sub is easily reached from any language and is the 
"standard" way of clearing either HIRES screen. 

It is also pitiful. 

It is pitifully s/ow in that it takes over eight times as long to clear the screen 
as is necessary, resulting in a slow and ugly glitch during screen clearings. And, 
it is pitifully weak in that it only lets you clear to a paltry 8 of the 191 HIRES 
colors. 

The FAST BACKGROUNDER is an incredibly fast machine-language module 
that will give you a right-now clear of HIRES to your choice of any 32 of the 
possible 191 color backgrounds or 18,446,744,073,709,551,616 color back- 
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ground patterns. The module is designed to load into the protected program 
space of HRCG (High-Resolution Character Generator) as the highest alternate 
character set, but the backgrounder can be used from any language or any 
graphics system. 

The FAST BACKGROUNDER is also useful in showing us quite a bit about the 
Apple’s HIRES color limits and capabilities. You can easily adapt parts of the 
program for your own special uses. You can also use the magic bit combinations 
to fill in your own colors in any way that you like. 

As with any program, there are trade-offs. In exchange for the blinding speed 
and the mind-boggling choice of colors and patterns, we end up with a fairly 
long module (512 bytes) that only can do a full clear of HIRES page One. While 
the module can handle any and all of the HIRES patterns and colors, its files are 
presently set up to only hold 32 different colors or patterns at any one time. 
Моге patterns or colors are easily swapped back and forth to disk or from your 
controlling program. You can easily customize the backgrounder or use the ideas 
behind it to handle almost any clear of any size, shape, or page that you like. 
You can also easily modify this upcoming FAST BACKGROUNDER.SET prog- 
ram to handle either page Two or your choice of either HIRES page. 

While the remaining visual glitch with this program is utterly negligible com- 
pared to the ugly transient that you get from the usual HIRES slow clear, we will 
also show you a way to get an absolutely glitchless and “invisible” clear to any 
color in the blink of an eye. 

Let's see how the Backgrounder works . . . . 


Lotsa dots 


How much do you know about the HIRES capabilities of the Apple? Which 
one of the following is correct? 


() In HIRES, the Apple can put a single dot in any of 560 
possible positions on any horizontal line. 


( ) In HIRES, the Apple can only put a maximum of 280 dots 
on any horizontal line. 


( ) In HIRES, the Apple can only put a maximum of 140 
green dots on any horizontal line. 


( ) Under worst-case conditions, the Apple will only allow 
40 HIRES color changes across the screen. 


The answer, of course, is yes. 

All of these statements are true. The Apple's horizontal resolution in HIRES 
is 40 dots, 140 dots, 280 dots, or 560 dots, depending on what you care to call 
a dot and how that dot has to relate to the others. 

Let's see if we can't straighten this mess out some. Refer back to Fig. 7-5 of 
the previous enhancement to get us started. 

As Fig. 7-5 showed us, there are forty bytes stored in memory for each 
horizontal line. Each byte is responsible for seven dots on the line. The leftmost 
byte is called the base address. The bytes continue in memory as base address 
+0, base address +1, base address +2, and so on, to base address + $27, 
which is the fortieth and rightmost byte on the line. The actual HIRES addresses 
for both pages were listed for you in Table 7-1 of the previous enhancement. 

As the sketch in Fig. 7-5 shows us, each HIRES byte, in turn, has eight bits. 
Seven of these bits are used to represent dots on one horizontal line. These dots 
are lit if the bit is a “опе” and are unlit or black if the bit is a "zero." 
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The bottom seven bits іп the byte map themselves backwards onto the screen. 
Thus, the least significant bit is the earliest and the leftmost, and the next-to-most 
significant seventh bit is the latest and, thus, the rightmost one to get plotted on 
the screen. 

What about the eighth, or most significant bit? This bit acts as a shifter that 
either does nothing or else moves a/l of the other seven dots one-half of a dot 
to the left. This shifting is detailed in Figs. 8-1 and 8-2. 


A ZERO IN THE MSB A "1" IN A DOT POSITION 
PICKS THE UNSHIFTED LIGHTS THAT DOT. A "0" 
COLORS OF GREEN LEAVE THAT DOT OFF. 
AND VIOLET. 


SECOND HORIZONTAL 
DISPLAY WORD 


FIRST HORIZONTAL 
DISPLAY WORD 


POSITIONS OF 


~ LEFT EDGE BYTE BYTE SHIFTED 
OF SCREEN COLOR COTS. 


Fig. 8-1. How unshifted colors are mapped onto HIRES screen. Note that even and odd word color bit positions are different. 


If the most significant bit is a zero, all the dots go where you would expect 
them to go. If the most significant bit is a one, all seven dots are all shifted 
together one-half dot to the right of their normal position. 

There are two reasons why you might like to shift all seven dots. In a black 
and white HIRES display, a half-dot shift of a dot can appear to double the 
apparent resolution on a slanty line, giving you the illusion of a 560-dot horizon- 
tal resolution. Unfortunately, all seven dots in a byte must shift or unshift to- 
gether, so this illusion fails if there is too much detail in the picture. The 
double-resolution illusion works best on simple large line figures that do not 
overlap. 

Shifting is also useful to smooth out or “round” characters іп a HIRES charac- 
ter set, or for other small and solid symbols where a half-step horizontal offset 
will even things out. Once again, all seven dots of a single byte must be shifted 
or unshifted at once. 

The second reason why you would want to shift all seven dots is that it gives 
you new colors on the screen. 
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A ONE IN THE MSB AS BEFORE А “1" 
PICKS THE SHIFTED IN A DOT POSITION 
COLORS OF BLUE LIGHTS THE DOT. A "0" 
AND ORANGE. LEAVES THAT DOT OFF. 


FIRST HORIZONTAL SECOND HORIZONTAL 
DISPLAY WORD DISPLAY WORD 


(VIOLET) (GREEN) 
-- — — 


———À —ÀM—— I. 
EVEN ODD 
DISPLAY DISPLAY POSITION OF 
"V. LEFT EDGE BYTE BYTE UNSHIFTED 
OF SCREEN COLOR DOTS 


Fig. 8-2. How shifted colors are mapped onto HIRES screen. MSB of each display word shifts or unshifts seven dots at once. 


Each dot position on a black and white set can either be lit or unlit. Lit gives 
you a white dot and unlit gives you a black dot. There are 280 possible dots on 
a horizontal line, equal to 40 bytes of 7 bits each. These dots can be placed in 
any of 560 possible positions, provided each group of 7 dots is shifted or not 
shifted as a block. 

You will get the same black and white display on a color tv set if you cancel 
the color burst with the software-controlled color killer of Enhancement 2, or 
if you back all the color controls completely off. 

Things get much more complicated if you want a color display. There is no 
way to produce a single white dot on a color tv set when the set is in its color 
mode. Each dot has to be a color since each dot consists of some red, blue, or 
green phosphor bars or dots on the screen. 

One way to gain insight into how a color tv works in an Apple display is to 
assume that the exact position of the dot determines the co/or that will be 
displayed. If your dots are unshifted, you can assume dot-position zero will be 
violet and dot-position one will be green and dot-position two will be violet 
again, and so on across the screen. 

If you have shifted your dots one-half dot, as we did in Fig. 8-2, you can 
assume that dot-position zero will be blue and dot-position one will be orange 
and dot-position two will be blue again, and so on across the screen. Your Apple 
can give you either green and violet dots inside a 7-dot byte, or else, it can give 
you orange and blue dots, again inside a 7-dot byte. You get the green and violet 
by unshifting the seven dots and you get the orange and blue by shifting the dots. 
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What actually goes on inside the tv is more complicated. Each dot pair 
represents one cycle of the 3.58-megahertz color reference provided by the 
Apple and used by the tv. The phase shift, or relative time delay, between this 
reference burst and the presence of a dot decides the color for that dot. Once 
the color is decided, the red, blue, and green phosphors are lit in the magic 
combination needed to get the right color. 

But, we are mainly interested in results rather than how those results are 
obtained. Instead, simply assume that each dot position is a unique color. 

Like so... 


Dot position 0.0... . violet 
Dot position 0.5 . . . . blue 
Dot position 1.0.... green 
Dot position 1.5 . . . . orange 
Dot position 2.0 . . . . violet 
Dot position 2.5... . blue 
Dot position 3.0.... green 
Dot position 3.5 . . . . orange 


... and so on across the screen. 

Now for the tricky part. The way you get a white dot or line on a color set 
is to light a pair of dots. Since green and violet are complementary colors, 
lighting both of them beside each other will appear to give you a double-wide 
white dot. Similarly, orange and blue are complementary colors. Lighting a pair 
of these, side-by-side, will also give you a white dot. 

Thus, it takes two dots, side-by-each, to give you the illusion of a white dot 
on a color tv. What really happens is that two adjacent dots of complementary 
colors get lit and you end up with the illusion of white light. 

All of which says that the color resolution of your Apple is only half as good 
as the black and white resolution. You can only put down 140 green dots on 
a horizontal line. Similarly, you can only put down 140 dots of any of the three 
other colors of violet, orange, or blue. You also can only put down 140 white 
dots, since a white dot really is a pair of adjacent color dots. 

Now, that sounds really awful, but most of it is the fault of the color tv, owing 
to the subcarrier method used to extract color. You can beat all this by going 
to a direct red, blue, and green video, like we may do in a later enhancement. 
If you are willing to directly enter the color guns, and if you are willing to add 
a small and very fast RAM after your Apple's circuitry, there is virtually no limit 
to the resolution, color range, or grey scale that you can get from your 
Apple. 

Right now though, there is also a further limitation, since each seven adjacent 
dots must be shifted or unshifted together. Thus, you cannot normally have a 
blue dot and a green dot right beside each other. Color changes are best left for 
different 7 -dot bytes, rather than being done inside a single 7-dot byte. At worst, 
you could be limited to as few as forty color changes across yoür screen if you 
are not careful about which colors have to go together. 

By the way, these are "nominal" colors. Your color tv settings can make a 
big difference in what you see or get. 

So, we see that there are absolute color limits which are set by the way the 
Apple and your color tv interact. We must obey these rules, at least for now. 
But, we are free to play any games within these limits to create the illusion of 
more colors than you'd think possible. This gets tricky, but it really works 
good. 
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Let's sum all this ир.... 


APPLE COLORS AND 
RESOLUTION 


1. In black and white, the Apple 
can put 280 dots or undots 
across the screen. 


These dots or undots can go 
in any of 560 possible loca- 
tions so long as 7 dots or un- 
dots in a byte are shifted at 
the same time. 


. In color, the Apple can only 
put down 140 dots of a given 
color on a horizontal line. The 


only dot colors are green, vio- 
let, orange, and blue. 


Green and violet are done 
with unshifted 7-dot bytes. 
Orange and blue are done 
with shifted 7-dot bytes. You 
cannot mix shifted and unshift- 
ed dots inside a 7-dot byte. 


. Also in color, the Apple can 
only give you a black and 
white resolution of 140 dots 
since a complementary dot 
pair must be lit to get the illu- 
sion of white light. 


The general idea is to use larger areas and many dots to trick the eye into 
seeing colors that are not there. This, of course, is the way all color printing 
works. Fortunately, the eye is much better at resolving detail than it is in resolving 
color, so we can get away with stunts like this. Let's see what we can get in the 
way of .... 


More colors 


A color tv only has three colors it can produce. These are red, blue, and green. 
But, it obviously plays games with combinations of these colors to give you a 
wide spectrum of colors; even some that do not exist elsewhere. 

You can do the same thing with your Apple. One possibility is to flash different 
colors in the same position on alternate fields. We may look at this in a future 
enhancement. This method will give you some apparently individual lines and 
сопе dots of different colors, but it also tends to flicker and it has other limiting 
actors. 
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instead, we will note that most colors used on your Apple will be used over 
a fairly large area. The days of stick figures and open lines on Apple HIRES are 
long since gone. Most colors will be presented over a wide area, rather than as 
a single line. Our Backgrounder will use the entire screen to create the illusion 
of having lots of HIRES colors. The same ideas are easily used to fill in colors 
inside any shape you like. 

The key to more colors is tricking the eye. One trick we can pull works in the 
vertical direction. If you take a pair of adjacent horizontal lines, апа make one 
blue and the other green, you will see aqua, particularly if there are many line 
pairs in use. By itself, use of line pairs of color should take the basic 6 colors 
and extend them to 21. This happens since 6 + 5 + 4 + 3 + 2 + 1 = 21, 
the number of possible pairs of 6 colors available. 

Most of these "new" colors formed by pairs of horizontal lines are very 
appealing and useful. A few are downright awful. Some look very good on a 
color set, while others stand out on a black and white display. A very careful 
choice of colors can give you the best of both worlds, with stunning colors that 
can still be resolved easily on a black and white display. This little detail can 
get very sticky if you are designing programs that can run on either type of 
tv set. 

Can we gain still more colors? What about the horizontal direction? Suppose 
we mix a color, then black, a color, then black, and so on? Or white, then a 
color, white, then a color, and continue this. Or, even alternate pairs of white 
and black spaced colors one line above the other? What you end up with is lots 
more colors. Some of these will have a texture to them and others will have lots 
of individual dots, sort of like the colors in the Sunday comics. Many of these 
new colors will be very useful. 

We will look at fourteen of these “new” colors. This brings up the total of solid 
or nearly solid colors per horizontal line to 20. Now, go to your alternating line 
pairs, and you end up with a total 20 + 19 +... + 2 + 1 = 210 possible 
HIRES colors. Nineteen of these have ugly black stripes in them, but | count 191 
that are genuinely useful HIRES colors so far. You might find more when you 
start to look at odd-ball bit combinations. 

The theoretical number of different HIRES colors is much higher than 210, but 
there are many duplicate, ugly, or useless results along the way. 

We will define our background colors with an 8-byte color cell as shown in 
Fig. 8-3. The cell is 4 bytes long by 2 bytes high. We have to be 4 bytes long 
since some of the color patterns will not repeat exactly until 28 dots. We end 
up with 2 bytes in height because we may use alternating line pairs for some 
colors. 

Our cell is two scan lines deep, starting with an even scan line and ending with 
an odd scan line. We then are free to use our second line in any of several ways. 
For instance, we can simply repeat the upper line for the traditional colors. We 
can make this second line white to lighten the color. In theory, we can leave 
the second line black to darken the color, but this tends to be too striped for 
most uses. We can also use our second line to mix hues for us, perhaps combin- 
ing blue and green to get aqua, and so on. 

Finally, we can use our second scan line to mess with the texture of our 
screen. We can use it to minimize the texture of the "comic book" colors as 
we will see shortly. Also, we can use this second scan line to purposely enhance 
texture—say, to emphasize a pattern or a design. 

Each 8-byte color cell will be controlled by an 8-entry color pattern file. The 
file values start at the top and work across. Thus, the first pattern is in the upper 
left, the fourth one is in the upper right, the fifth one is in the lower left, and, 
finally, the eighth one controls the bottom right seven dots in the cell. 
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8-ВУТЕ 
COLOR 


PATTERN | ѕ2 | sss | $2A $55 | $05 | SAA] sos | saa | 


О= ит 

@ = OUT 

П = UNSHIFTED 
= SHIFTED 


ФОФОФОФОФОФОФО! 


{п this example, green is used on even scan lines and blue із used оп odd scan тоз to give an aqua screen. 


Fig. 8-3. Fast BACKGROUND.SET program uses ап 8-byte color pattern file to map a 56-dot, 4x2-byte color block on the screen. 


№ our colors are going to appear to be continuous over the entire screen, we 
have to obey an important ге... 


For continuous background color, 
the bit patterns must repeat 
EXACTLY when going across both 


7-dot-byte boundaries and 8-byte 
cell boundaries. 


What this says is that you have to be very careful in your choice of the ones 
and zeros in your individual bits and bytes. Otherwise, you will get lots of stripes 
across the screen and end up with a pattern instead of a color. 

Now, if you want patterns, that's fine. Just stuff any old 64 bits into your cell 
(56 color dots and 8 half-dot shifts) and out comes a pattern. Some of these 
patterns are stunning. Some are ugly, others awful. Many are boring. Some can 
be used to, say, do a chain-link fence, or frost glass, or simulate a lace dress. 
Others are nice for curtain effects, used either in a window or as a full-screen 
stage. 

There are more than several patterns available to you. Quite a few, in fact. 
Run through the mathematics and you'll find that there is a grand total 
of 186,446,744,073,709,551,616 possible patterns for your 8-byte cell. 

This is so many patterns, in fact, that you might never be able to get through 
them all. So we will all share the work. Assume that there are only 125,000 
readers of this book. A gruesomely conservative thought, but let's assume it 
anyway. Your share of the patterns will then only be a measly one and a half 
quadrillion patterns, give or take a few. 

What I'd like you to do is this. Go through your share of the patterns one by 
one and when you find some really and truly outstanding ones, jot them down 
on the card that is in the back of this book and mail it in, and we'll publish the 
best patterns, textures, and colors that we get in a future volume of enhance- 
ments, 
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Pattern codes 


Back to our colors. Seven is a nasty number. № is both odd and prime. 
Remember that we must get the dot patterns to repeat every byte and every cell, 
continuously, if we are to have a solid color rather than a pattern. This severely 
restricts the codes you can use. There are only two patterns that will repeat 
identically with every byte. There are four new patterns that will repeat identical- 
ly with every second byte. | 

If we май for а period of three bytes for our patterns to repeat, we pick ир 
four more new and different patterns. Actually, these won't quite map into our 
upcoming 4-cell backgrounder space, and we will be violating our “it must fit 
exactly” rule. But, we will show you these three-byters just in case you want 
to play with them. 

For maximum flexibility and the greatest possible choice of colors, we have 
to be willing to make four bytes, in a row, have different codings. We also have 
the option of stacking two different pairs of four bytes for even more color 
combinations. 

The 4-byte patterns will give us ten new and useful combinations, Actually, 
there are many more 4-byte patterns possible, but these are either offset replicas 
of other 4-byte patterns, or else, they give the same color but a different texture. 
More details on this will be given shortly. 

Summing things ир.... 


NEW HIRES COLORS 


NO.OF BYTES NO. OF NEW COLORS 


One 
Two 4 
Three 4 
Four 


Total number of combinations of pairs of 
20 colors = 20+19+18+17 + ...,ог 
n(n+1)/2 = 210. 


possible colors 
— ugly colors 


total 
Tota! number of obvious and useful 


HIRES colors = 191. 


Someone else will most likely come up with some more subtle bit combina- 
tions that can lead to even more HIRES colors. But, no matter whose math you 
use, you will see that . . . 


There are many more HIRES colors 
available on an Apple than there 


are LORES colors! 


The big advantage of the 121 LORES colors of Enhancement 5 was that you 
got more hues, while with the HIRES combinations, you tend to get more shades 
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of fewer actual hues. Either route will lead to some mind-blowing color 
displays. 

Let's look at these 1-, 2-, 3-, and 4-byte color combinations in detail. We will 
first look at combinations that only involve a single horizontal line. 

There are only four possible bit patterns that leave all four bytes identical. Two 
of these are white, and two are black. Here's what they look like . . . 


$00.00-00-00 ОООООООООООООООООООООООООООО (white) 
$80-80.80-80 ОООООООООООООООООООООООООООО мне) 
$7F-7F-7F-7F 0000000000000000000000000000 ос“) 
SFF-FF-FF-FF 0000000000000000000000000000 (27 


* = shifted color, О = lit dot 


There are two black patterns and two white ones. Both blacks will look the 
same. The whites will be pretty much the same, although one may end up 
slightly “warmer” than the other. Usually, you use unshifted black and white 
with the upcoming green and violet, and use shifted black and white with 
orange and blue. 

Note that there is no way to get any other continuous HIRES color by writing 
the same value to each and every byte. You can only get white and black this 
way. Апу other values will give you stripes or patterns rather than solid colors. 

If we go to pairs of horizontal bytes, we add these four solid colors . . . 


52А-55-2А.55 ФОФОФОФОФОФОФОФОФОФОФОФОФОФО (oreen) 
$АА-05-АА-05 ФОФОФОФОФОФОФОФОФОФОФОФОФОФО orange)’ 
$55-2А-552А ОФОФОФОФОФОФОФОФОФОФОФОФОФОФ (мое 
505-АА-05-А ОФООФОФОСФОӨСОСФОӨСФОӨСФСОФОФСӨ (blue) 


* = shilted color 


These are the usual “ери!” colors provided by Apple in its HIRES routines. 
You have four solid colors, two blacks, and two whites. 

Note particularly how each second byte has to have a different bit pattern 
for the colors. The bit pattern has to be continuous over the screen. Since there 
are an odd number of bits per byte, this means that the 2-byte colors have to 
be stored as different values. 


To make things more interesting, let’s now look at four more new 3-byte 
patterns... . 


$49-25-12 ФООФООФООФООФООФООФОО 6n 
5С9-А5-52 ФООФООФООФООФООФООФОО (32): 
836-5860 ОФОФОФФСОСӨФСОФФСФӨСӨФӨ (эз) 
SBE-DB-ED ОФФОФФОФФОФФОФФОФФОӨФӨ o» 


* = shifted color 


At first glance, you might think we would have more 3-color patterns than this. 
We already have used up the all-white and all-black patterns as 4-byte colors. 
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And, the other combinations are simply “phase shifts" or offsets of what we 
already have. For instance, the pattern $25-12-49 gives us the same color as 
$49-25-12, only with the actual dot pattern shifted one byte to the right. This 
offset shift will give us nothing new in the way of color, but might be useful to 
minimize any background pattern. We will see a good example of this with our 
4-color patterns. 

In general, the 3-color patterns are kind of bland greys and are not too 
exciting. Their use gets complicated by the need for us to handle things “Бу 
fours” in our upcoming fast background program. While we won't be using these 
too much here, you might find the 3-byte colors useful additions to your bag 
of tricks. 

Some of the 4-byte patterns are really neat. There are ten new and useful ones. 
We pick up four new pastels, two greys, and four dark colors. Let's start with 
the pastels .... 


$11-2224408 ФОООФОООФОООФОООФОООФОСООФООО (ите green) 
$91-A2-C4-28 ФОООФОООФОООФОООФОООФОООФООО sky өше) 
$22-44-08-11 ОФОООФОООФОООФОООФОООФОООФОО (нас) 
$A2-C4-88-91 ОФОООФОООФОООФОООФОООФОООФОО еще» 


* = shifted cotor 


These four new “pastel” colors will ако have four identical other ones, offset 
by two bytes. These add nothing new in the way of color, but give us a way 
to break up any background pattern. 

For instance, we can do this for lime green . . . 


ФОООФОООФОООФО 
ФОООФОООФОООӨО 
өөө өөө; [өөө ө, 
ФОООФОООФООСФО 
eoooeocooecooeo 


.. . here we used the same pattern оп all four scan lines. But, if we alternate 
the regular and the offset pattern on alternate scan lines, note how the texture 
"breaks ир”.... 


eoooecooecocoeo 
осоФОООФОООФООО 
өөө өөө [өөө ө, 
ООФОООФОООФООО 
@OOO@OOO@OOO@O 


Both displays are lime green. But the bottom choice will give us a more 
uniform lime green, since the texture is broken up. This becomes most obvious 
with the upcoming dark colors. 

We will shortly be listing some of these color patterns. À “normal” color 
pattern should usually be used on the even scan lines of any color area, while 
an “offset” color pattern should be used on the odd scan lines of any color area. 
You are, of course, free to do whatever you like for special effects. Sometimes, 
you might want to enhance texture rather than trying to minimize it. 
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Неге are our two new greys... 


$33-66-4C-19 ФФОООООФФООФФООФФООФФООСФӨССО (rey 1) 
$B3-E6-CC-AS9 ФФОСОФФООФФООРФООФФООФФООФӨСОСО grey 2* 


* = shilted color 


Once again, there really are at least four greys—one normal and one offset by 
two bytes. Notice one more time how we can emphasize or reduce texture with 
the choice of regular or offset colors . . . . 


ФФООСФФОСОСФФОСОФӘ 0000000000006 
ФФООСФФОСОСФФОСОФӘ OOeecoeecceeco 
eecceecoceeccee ФФООСФФОСОСФФОСФӘ 
00000000000000 ООФФООФФООСФӨСО 
00000000000000 eeococeecceecocee 


These are subtle differences to be sure, but they get important real quick when 
you try to build something that looks good both on a black and white and a color 
tv screen. 

Our final four colors are dark ones, since they hit one color dot, miss the next 
dot of the same color, then hit the next one, and so on. Here is what they look 
like .... 


56Е-50-38-7 ОФФОСФФФОФФФОФФФОФФФОФФФОФФФӨ (purple) 
$DD-BB-F7-EE ОФФФОФФФОСФФФОСФФФОСОӨФФОФФФСФФӨ (navy вие): 
$5D-3B-77-6E ФОФФСФФФОСФФОСФФОФФФОФФФСФӨ (forest green) 
SEE-DD-BB-F7 ФОСОФОФФФОСОФФСОСФФФОФФФОФФФСФӨ = brown): 


* = shifted color 


These tend to give a “comic book” or “Sunday funnies” effect at close range 
and are just what you need to add variety to a HIRES color palette. 

You could probably go on to 5-byte colors, and 6-byte colors, and so on, but 
things would most likely end up so spread out that you no longer would see any 
apparently solid colors. You could also go to patterns of two lit, three off, and 
50 on, as well. Chances are that most of these new patterns will either be obvious 
or else very near to what we already have. But—check them out anyway, since 
there are bound to be some useful surprises along the way. 

If you do go into your own exotic patterns, be sure to remember our rule that 
the bit pattern on the screen must repeat exact/y across each byte boundary and 
for each 8-byte, 4 x 2 cell. 

Add everything useful up so far, and you get 20 one-line colors. We are now 
free to use our second scan line to add to our basic 20 colors. As we have seen, 
you can use this second line to duplicate colors, to offset bytes for minimum 
patterns, to mix hues together, to lighten, to darken, or to actually emphasize 
patterns. These new combinations give you at least 220 colors. This drops to 191 
when you remove the 19 uglies that you get when you try to darken with a black 
line. 

Table 8-1 shows my choice of color-file values for the thirty-two most useful 
colors and patterns. We start with Apple's own six colors. Here the first and 
second scan lines are identical. Then we add fourteen of the 4-byte colors. With 
the 4-byte colors, we use the second scan line to offset and minimize any screen 
patterns. 
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Table 8-1. File Values for “Stock” Background Colors 


SECOND 
NO. COLOR HEX FILE VALUES DECIMAL FILE VALUES LINEUSE 


blacki %00-00-00-00-00-00-00-00 00-00-00-00-00-00-00-00 duplicate 
green $2A-55-2A-55-2A-55-2A-55 42-85-42-85-42-85-42-85 duplicate 
blue $05-АА-05-АА-05-АА-05-АА 213-170-213-170-213-170-213-170 duplicate 
whitel %7Ғ-7Ғ-7Е-7Ғ-7Ғ-7Ғ-7Ғ-7Ғ 127-127-127-127-127-127-127-127 duplicate 


black2 $80-80-80-80-80-80-80-80 128-128-128-128-128-128-128-128 duplicate 
violet $55-2А-55-2А-55-2А-55-2А 85-42-85-42-85-42-85-42 duplicate 
orange $AA-D5-AA-D5-AA-D5-AA-D5 170-213-170-213-170-213-170-213 duplicate 
white2 ФЕҒ-ҒҒ-ҒҒ-ҒҒ-ҒҒ-ҒҒ-ҒҒ-ҒҒ 255-255-255-255-255-255-255-255 duplicate 


purple %11-22-44-08-44-08-11-22 17-34-66-08-66-08-17-34 offset 
navy $91-A2-C4-88-C4-88-91-A2 145-162-196-136-196-136-145-162 offset 
forest $22-44-08-11-08-11-22-44 34-66-08-17-08-17-34-66 ofíset 
brown  $A2-C4-88-91-88-91-A2-C4  162-196-136-145-136-145-162-196 offset 


grey] — $33-66-4C-19-4C-19-33-66 51-102-76-25-76-25-51-102 offset 
grey2 $B3-E6-CC-99-CC-99-B3-E6 179-230-204-153-204-153-179-230 offset 
lime $6E-5D-3B-77-3B-77-6E-5D 110-93-59-119-59-119-110-93 offset 
lilac $5D-3B-77-6E-77-6E-5D-38 93-59-119-110-119-110-93-59 offset 


beige  $EE-DD-BB-F7-BB-F7-EE-DD 238-221-187-247-187-247-238-221 offset 
sky $DD-BB-F7-EE-F7-EE-DD-BB 221-187-247-238-247-238-221-187 offset 
aqua $2A-55-2A-55-D5-AA-D5-AA 42-85-42-85-213-170-213-170 mix hues 
steel $2A-55-2A-55-55-2A-55-2A 42-85-42-85-85-42-85-42 mix hues 


yellow $2А-55-2А-55-АА-05-АА-05 42-85-42-85-170-213-170-213 mix hues 
powder $05-АА-05-АА-55-АА-55-АА 213-170-213-170-85-42-85-42 mix hues 
pink $D5-AA-D5-AA-AA-D5-AA-D5 213-170-213-170-170-213-170-213 mix hues 
magenta $AA-D5-AA-D5-55-2A-55-2A 170-213-170-213-85-42-85-42 mix hues 


olive $2A-55-2A-55-7F-7F-7F-7F 42-85-42-85-127-127-127-127 lighten 
silver — $D5-AA-D5S-AA-FF-FF-FF-FF 213-170-213-170-255-255-255-255 lighten 
salmon $AA-D5-AA-D5-FF-FF-FF-FF 170-213-170-213-255-255-255-255 lighten 
mauve $55-2A-55-2A-7F-7F-7F-7F 85-42-85-42-127-127-127-127 lighten 


drapel $C1-A3-A5-89-2C-08-CD-FE 193-163-165-137-44-8-205-254 Pattern 
drape2 $9A-43-54-18-05-26-53-01 154-67-84-24-5-30-83-1 pattern 
сһаіп! %00-7Ғ-00-7Ғ-7Ғ-00-7Ғ-00 0-127-0-127-127-0-127-0 texture 
chain2 $0F-OF-OF-OF-78-¥8-78-78 15-15-15-15-120-120-120-120 texture 


NOTE: Colors will vary with tv and its adjustments. 


Next, in the file, are six mixed hue colors. Of these, aqua and magenta are 
particularly good looking. We do the mixing by putting down one color on one 
scan line and a second color on the second scan line. Following this are four 
colors in which the second scan line is white, giving us some additional pastels. 
Finally, we have four examples of patterns in which the scan lines are used to 
emphasize, rather than minimize the texture. Two stage “curtains” and two 
“chain” effects are shown. 

Naturally, you are free to mix and match things anyway you want for your 
own color files. You can also use the same patterns to fill much smaller areas 
than the whole screen, although it will often take several scan lines and a few 
bytes of width to get a pleasing result. 

Well, that's about all we need in the way of HIRES color theory. All you have 
to do to color any part of the screen 191 ways is to paint an 8-byte block of 
the screen with the magic bytes. If you need partial blocks, you simply continue 
the bit pattern up to the border of whatever it is you are coloring. Some colors 
will not be compatible with some borders, so you have to experiment to get the 
best overall results. 
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For patterns instead of colors, you do the same thing. The only difference is 
that you now have a mind-boggling choice of special effects at your disposal. 

By the way, our color names are only rough guidelines. The actual colors you 
get will vary with the tv and its color settings. 

Now all we need is a snappy program to rapidly clear the HIRES screen for 
us. Something like... . 


FAST BACKGROUND.SET 


Program 8-1 is a machine-language subroutine called FAST BACKGROUND. 
SET. While it is designed to fit in an alternate character slot in the HRCG of the 
DOS Toolkit, you can use it with any program in any language that needs a fast 
clear of HIREST. Remember that the program must be located т a protected 
space. 

Many of the ideas behind this program are the same as we used in the GENTLE 
SCROLL.SET of the previous enhancement. To give us the fastest possible screen 
erasure, we work only with the entire screen at once, use fast indexed store 
instructions, and share our loop overhead sixteen ways at once. 

There are two main parts to the program. The operating code goes from 
$8AFF to 8BFF, while a 32-value color file resides from %8С00 to $8CFF. To 
use the program, you poke or load your choice of color or pattern into location 
$8B00, which is the same as an Applesoft POKE to 35584. This color value will 
be a number from 0 to 31. You then activate the fast background clear by jump- 
ing to a subroutine at $8B01 or calling 35585. 

Table 8-2 shows you the color-file values as they are now. Each color takes 
up 8 successive bytes in the file, giving us 32 total colors or patterns in the 
one-page-long file. You can change any or all of these color values to suit your 
own needs. 

A flowchart of the FAST BACKGROUND.SET is shown in Fig. 8-4. We first 
calculate a file pointer by multiplying the color times eight. Then, we get the first 
color byte and use this byte in 1024 places, arranged as sixteen lines of 64 bytes 
per line. Note that we only map every fourth byte of only the even scan lines 
when we put this byte down. 

We then get the second byte and put it down, again in 1024 locations. This 
is followed by the third byte and, finally, the fourth, which completes the even 
scan line mappings. 

After that, we repeat the process on the odd scan lines, starting with the fifth 
byte in the selected color file and going on until we end up on the eighth and 
final value. When you are done, you have mapped 8 cells of 4 х 2 bytes into 
1024 locations, or 8192 bytes total. Most of these bytes are on screen, while 
a few are off screen but not otherwise used. 

Program 8-2 is an Applesoft demo that either shows you your choice of all 
32 colors or patterns in order, or lets you enter and view your own patterns, or 
gives you a random-background show. It is menu driven. 

For a 32-color show, the desired color gets POKED and the FAST BACK- 
GROUND.SET is called. Then, a several second delay takes place, and you go 
on to the next color. Be sure to note that the screen clear takes place on the 
color change, and not on the long viewing delay. The screen clears or changes 
literally as fast as you can blink your eye. 

To enter your own color or pattern, color-file location 0, or the eight bytes 
from $8C00 to %8С07, is borrowed, and the pattern is stuffed in here. This 
pattern is then displayed. 

The random-color show does pretty much the same thing except the program 
throws its own eight random numbers into color-file Zero. Should you want to 
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PROGRAM 8-1 
FAST BACKGROUND SET 


LANGUAGE: APPLE ASSEMBLER NEEDS: FIELD SYNC 
MOD (OPTIONAL) 


ВАЕЕ: А КАСАС 


ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
BAFF: 
BAFF: 
BAFF: 
BAFF: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 


FAST 
BACKGROUND. SET 
(SSAFF.8CFF ) 


VERSION 1.1 
(10-9-81 ) 


~. <+ же че ~a «4 <+ ча че зө ч 


ВУ DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


ххх жи FH Ht * * + * * 


* 
* 
* 
* 
* 
* 
ж 
ж 
* COPYRIGHT 1981 
* 
* 
* 
* 
* 
* 
ж 


* k k 'k k k k k k * k k k k КК КК 


. 
г 
. 
4 
. 
LÀ 
. 
LI 
. 
Ç 
. 
Ф 


ВАЕЕ: ; ТНІ5 РВОСВАМ СТУЕ5 А ҒА5Т НІКЕ5 
ВАЕЕ: ; CLEAR ТО АМҮ ОҒ THIRTY TWO 
ВАЕЕ: BACKGROUND COLORS OR PATTERNS 


ВАЕЕ: FROM HRCG -- 


BAFF: 
8AFF: 
8AFF: 
8AFF: 
8AFF: 


LOAD AS HIGHEST CHARACTER SET 
SET USER SUB A TO 58801 

BY $9150: 01 8B 

STORE COLOR (0-$1F) АТ $8800 
CTRL-A CTRL-Y DOES IT 


M. Se se че so 


8AFF: MACHINE LANGUAGE -- 

8AFF: PUT COLOR ($0-$1Е) IN $8BOO 
ЗАЕЕ: JSR $8801 

SAFF: INTEGER BASIC -- 

ВАЕЕ: $ЕТ НЇМЕМ > -29953 


ВАЕЕ: РОКЕ -29952, COLOR (0-31) 
ВАЕЕ: CALL -29951 
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PROGRAM 8-1, CONT’D... 


ВАЕЕ: FROM APPLESOFT -- 


^e 


ВАЕЕ: 
SAFF: 
ВАЕЕ: 


SET НІМЕМ < 35583 
РОКЕ 35584, COLOR (0-31) 
CALL 35585 


se x 5o 


ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 
ВАЕЕ: 


THERE IS AN OPTIONAL "INVISIBLE" 
GLITCH ELIMINATOR BUILT INTO 
THIS PROGRAM. TO USE IT, YOU 
MUST CLEAR THE LORES SCREEN TO 
GREY AND SHOULD HAVE THE FIELD 
SYNC MOD IN PLACE. 


~e "9 ме 99 np че 


8AFF: TO ACTIVATE THE INVISIBLE SWITCHER -- 


`. 


8AFF: POKE 35586,159 OR $8B01: 9F 


=e 


ВАЕЕ: TO TURN OFF THE INVISIBLE SWITCHER -- 


`. 


ВАЕЕ: POKE 35586,04 OR $8802: 04 


~e 


66 HIRES EQU  $C057 
67 LORES EQU $СО56 
68 SYNC EQU  $CO60 


PROGRAM 8-1, CONT’D... 


ВАЕЕ: 


ВАЕЕ: 00 
8В00:00 
8В01:4С 
8В04:18 
8B05:AD 
8В08:0А 
8В09:0А 
8BOA: OA 
Ввов: АВ 
ВВОС:А2 
8В0Е:98 
8BOF:48 


8B10:B9 
8B13:A0 
8B15:9D 
8B18:9D 
8B1B:9D 
8BlE:9D 
8B21:9D 
8B24:9D 
8B27:9D 
8B2A:9D 
8B2D:9D 
8B30:9D 
8B33:9D 
8B36:9D 
8B39:9D 
8B3C:9D 
8B3F:9D 
8B42:9D 
8B45:CA 
8B46:CA 
8B47:CA 
8B48:CA 
8в49.: 88 
8B4A:D0 
8B4C:E8 
8B4D:68 
8В4Е:69 
8В50:А8 


8В51:29 
8B53:DO 


8B55:A2 
8B57:98 
8В58:48 
8В59:В9 
8B5C:A0 


73 
74 


83 
84 


86 
87 
88 
89 
90 
91 
92 


COLOR 


NXTBYT 


MAPEVN 


NXBYTE 


++} 


DFB 
DFB 
JMP 
CLC 
LDA 
ASLA 
ASLA 
ASLA 
TAY 
LDX 
TYA 
PHA 


LDA 
LDY 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
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MAIN PROGRAM ****** 


$00 
$00 
ERASE 


COLOR 


$$00 


CFILE,Y 
$$40 

$2000,X 
$2100,X 
$2200,X 
$2300,X 
$2800,X 
$2900,X 
$2A00,X 
52В00,Х 
53000,Х 
$3100,X 
$3200,X 
$3300,X 
$3800,X 
$3900,X 
$3A00,X 
$3B00,X 


MAPEVN 
#501 
#503 
NXTBYT 


#$00 


CFILE,Y 
#$40 


se ^9 ча 99 ~o мә че че ча so ~e ~e 


M» че wa ~e че че че чо че че че че че че че мэ че ча че ча че че че че че че че че 


ADJUST HRCG SET START 
COLOR POKES HERE 
OPTIONAL INVISIBLE LOCK 
FILE POINTER * 8 

GET COLOR 


SAVE COLOR FILE START 
AND PUT DOWN COLOR 
RESTORE POINTER 
AND SAVE ON STACK 


CHANGE EVEN SCAN LINES 
FOR 64 TRIPS. 


GO FOUR BLOCKS TO LEFT 


AND REPEAT 
DONE WITH 64 BYTES? 


FOR NEXT COLOR BYTE 
GET BYTE COUNTER 

AND INCREMENT 

SAVE NEXT COLOR FILE 
POINTER 

CHECK FOR FOURTH TRIP 
REPEAT FOR NEXT BYTE 


AND PUT DOWN COLOR 
RESTORE POINTER 
AND SAVE ON STACK 
CHANGE ODD SCAN LINES 
FOR 64 TRIPS 
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PROGRAM 8-1, СОМТ?... 


8B5E:9D OO 24 122 MAPODD $2400,X 
8B61:9D 25 123 $2500,X 
8B64:9D 26 124 $2600,X 
8B67:9D 27 125 $2700,X 
8B6A:9D 2C 126 52С00,Х 
8B6D:9D 2D 127 52000,Х 
8в70:90 2Е 128 82Е00,Х 
8B73:9D 2F 129 $2F00,X 
8B76:9D 34 130 $3400,X 
8B79:9D 35 131 $3500,X 
8B7C:9D 132 $3600,X 
8B7F:9D 133 $3700,X 
8B82:9D 134 $3COO,X 
8B85:9D 135 $3D00,X 
8B88:9D 136 $3E00,X 
8B8B:9D 137 $3F00,X 
8B8E:CA 138 

ВВВЕ :СА 139 

8890: СА 140 

8В91:СА 141 

8в92:88 142 

8B93:D0 143 MAPODD 
8895": E8 144 

8в96:68 145 

8897 :69 146 #501 
8В99:А8 147 

8B9A:29 148 #$03 
8B9C:DO 149 NXBYTE 


GO FOUR BLOCKS TO LEFT 


AND REPEAT 
ONE LESS TRIP 


FOR NEXT COLOR BYTE 

GET BYTE COUNTER 

AND INCREMENT 

SAVE COLOR FILE LOCATION 
FOURTH TRIP? 

REPEAT FOR NEXT BYTE 


. 
# 
- 
Li 
. 
Li 
. 
Li 
E] 
E 
е 
Li 
е 
2 
. 
, 
. 
СД 
е 
+ 
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8B9E:60 151 ; EXIT WHEN DONE 


154 ; *** INVISIBLE SWITCHER *** 


8B9F:2C 156 TEST1 
8BA2:10 157 
8ВА4:2С 158 
ВВА7:20 159 
8BAA: 2C 160 TEST2 
8BAD:10 161 
8BAF : 2C 162 
8BB2:60 163 


LOOK FOR VBLANK 


SWITCH TO LORES GREY 
DO FAST HIRES CLEAR 
FIND ANOTHER VBLANK 


SWITCH BACK TO HIRES 
AND EXIT 


~e 99 9$ че ча ~e ~e so 
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PROGRAM 8-1, CONT’D... 
8BB3: 165 ***** COLOR PATTERN FILE ***** 


8С00: 167 COLOR+256 


8C00:00 $00, $00, $00, $00, $00, $00, $00, $00 
8С03:00 
8С06:00 
8С08:2А $2A,$55,$2A,$55,$2A,$55,$2A,$55 
8COB:55 
8COE:2A 
8C10:D5 5р5, SAA, $05, SAA, 505, SAA, SD5, SAA 
8C13:AA 
8C16:D5 
8C18:7F S7F,S7F,S7F,S7F,$7F,S$7F, $7F, $7F 
8C1B:7F 
ВС1Е:7Е 
8С20:80 $80,$80, $80, $80, $80, $80, $80, $80 
8с23:80 
8с26:80 
ВС2В:2А 
8С2Е:55 
8C30:AA SAA, $05, SAA, $05, $АА, $D5, $AA, $05 
8C33:D5 
8C36:AA 
8C38:FF SFF,SFF,SFF,SFF,SFF,SFF,SFF,SFF 
8C3B: FF 
8C3E:FF 
8с40:11 $11,$22, $44, $08, $44, $08, $11,$22 
8C43:08 
8C46:11 
8C48:91 $91, $А2, $С4, $88, $С4, $88, $91, $А2 
8с4в:88 
8С4Е: 91 
8C53:11 
8C56:22 
8С58:А2 $A2,$C4,$88,$91,$88,$91,$A2,$C4 
8C5B:91 
8C5E:A2 
8С63:19 
8С66:33 
8C68:B3 $B3, SE6, $СС, $99, $CC, $99, $B3, $Еб 
8C6B:99 
8C6E:B3 
8C70:6E $6E,$5D,$3B,$77,$3B,$77,$6E,$5D 
8с73:77 
8С76:6Е 
8C78:5D $5D,$3B,$77, $6E, $77, $6E,$5D,$3B 
8C7B:6E 
8C7E:5D 
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———————————у———— 


PROGRAM 8-1, CONT’D... 


8C80:EE DD ВВ 186 SEE,SDD,SBB, $F7, $BB, $F7, $EE, $DD 
8C83:F7 BB F7 

8C86:EE DD 

8C88:DD BB F7 187 SDD,SBB,SF7,SEE,SF7,SEE, SDD, $BB 
8C8B:EE F7 EE 

8C8E:DD ВВ 

8C90:2A 55 2A 188 $2А, $55, $2А, $55, $05, SAA, $05, SAA 
8С93:55 05 

8с96:05 АА 

8С98:2А 55 189 $2А,$55,$2А, $55, $55, $2А, $55, $2А 
8С9В:55 55 

8С9Е:55 2А 

8САО:2А 55 190 $2А, $55, $2А, $55, SAA, $05, SAA, $05 
ВСАЗ:55 АА 

8СА6:АА 05 

8CA8:D5 АА 191 505, АА, $05, ЗАА,555,52А,555,52А 
SCAB:AA 55 

8CAE:55 2A 

8CBO:D5 AA 192 $D5,$AA, $D5, SAA, SAA, $D5, SAA, 505 
ВСВЗ:АА АА 

8СВ6:АА 05 

8CB8:AA 193 $AA,$D5,SAA,$D5,$55,$2A,$55,$2A 
8CBB:D5 

8CBE:55 

8CCO: 2A 194 $2А, $55, $2А, $55, $7Е, $7Е, $7Е, $7Е 
8CC3:55 

8CC6:7F 

B8CC8:D5 195 5р5,5АА,5р5,5АА,5ҒЕ,5ҒЕ,5ЕЕ,5ЕЕ 
8CCB:AA 

8CCE:FF 

8CDO:AA 196 SAA, $05, ЗАА, $05, SFF,SFF,SFF,SFF 
8CD3:D5 

8CD6: FF 

8Ср8:55 197 555, 82А,855,82А,87Е,87Е,87Е,87Е 
8CDB: 2A 

8CDE:7F 

8CEO:Cl 198 $С1,$АЗ, $А5, $89, $2С, $08, SCD, $FE 
8СЕЗ:89 

8CE6:CD 

8CE8:9A 199 59А,543,554,518,505,526,553,501 
8СЕВ:18 

8СЕЕ:53 

8CFO:00 200 $00,$7F,$00,$7F,$7F,$00,$7F,$00 
ВСЕЗ: 7Е 

8CF6:7F 

8CF8: OF 201 SOF, SOF,SOF,SOF,SF8,SF8,SF8,SF8 
8CFB: OF 

8CFE:F8 


*** SUCCESSFUL ASSEMBLY: NO ERRORS 
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Table 8-2. Color-File Locations Used in FAST BACKGROUND.SET 


PATTERN HEX LOCATION DECIMAL LOCATION 


In hex, LOCATION = $8С00 + $PATTERN *8. 
іп decimal, LOCATION = 35840 + PATTERN *8. 


hold these values for later use, stop the program with a “Control С” at that point. 
To resume, type “КОМ” as usual. 

By the way, all the programs in this book have been modified to automatically 
exit you to the AUTO MENU program on the demo disk, so you can continuous- 
ly run things without lots of extra keystrokes. Be sure to delete the "RUN 
MENU” exit lines if you do not want this feature in any of your programs. 


ADD-ONS AND MODIFICATIONS 


You can relocate the FAST BACKGROUND.SET anywhere you like, but notice 
that the file values will change. It is also important to start the color file on an 
exact page boundary. The space you pick must be protected from use by any 
other program. Usually, an Applesoft HIMEM command will do this for you 
either as a direct command or early in a program. 

Naturally, you cannot see a fast background HIRES clear if you are in the text 
or LORES screen modes. To actually see the fast clear, you must be in HIREST 
when you do the erasure. 
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ЕІМО ЅТААТ | 
OF COLOR | 
FILE | 


Ротоомм | ` 
1024EVEN | ` 
SCAN BYTES | ` 


GET NEXT 
COLOR FILE 


| м j| 2 | | Матти | 


BLANKING HE 
TIME 


DONE ЗА 
WITH EVEN ($885; : 
>_ SCANS? ү | SWITCH TO 


| LORES1 GREY 


PUT DOWN ` 
1024006 | 8859) DO HIRES 
SCAN BYTES FAST 
— E Ñ BACKGROUND 


GET NEXT 
COLOR FILE 395 WAIT TILL 
VALUE BLANKING 
—— TIME 


DONE WA SWITCH 
WITH ODD завос то 
SCANS? , T HIRES1 


Fig. 8-4. Flowchart of FAST Fig. 8-5. Flowchart of optional “Invisible 
BACKGROUND.SET program. Switcher.” 


There are several different ways you can pick up a clear of HIRES page Two. To 
only clear HIRES2, just replace all the “2ХХХ” addresses with “4XXX” and 
all the “3ХХХ” addresses with “БХХХ” ones. You can also duplicate the entire 
program and put it above $8000, sharing a common color file at $8С00, with 
calls to the lower part giving you a HIRES1 clear and calls to the upper part giving 
you a HIRES2 clear. 

Finally, if saving code space is important, you can also rework the MAPEVN 
and the MAPODD stores into subroutines. Jump to the "2XXX" and "3XXX" 
subs for a page One clear and to the “4ХХХ” and “5ХХХ” subs for a page Two 
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PROGRAM 8-2 
FAST BACKGROUND DEMO 


LANGUAGE: APPLESOFT NEEDS: FAST BACKGROUND SET 


10 REM * k k x k k * k k k k * k K k *k K k k k Ж 


12 REM 
14 REM 
16 REM 
18 REM 
20 REM 
22 REM 
23 REM 
24 REM 
26 REM 
28 REM 
30 REM 
32 REM 
34 REM 
36 REM 
38 REM 


FAST BACKGROUND 
DEMO 


VERSION 1.0 
(10-6-81) 


COPYRIGHT 1981 
BY DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


e+e +++ +*+ +++ 
хх ххх HF 3 HF Ұ HH + 


+ k * k k k k k k k k k k k k k k * k 


50 REM THIS PROGRAM TESTS AND 
52 REM DEMONSTRATES THE FAST 
54 REM BACKGROUNDER FOUND IN 
56 REM ENHANCEMENT EIGHT OF 

58 REM ENHANCING YOUR APPLE II 
60 REM VOLUME I. 


70 REM "THE PROGRAM "FAST 
КЕМ  BACKGROUND.SET" IS 
REM IS ALSO NEEDED ON 
REM THE SAME DISK. 


REM THE FIELD SYNC MOD 
REM ОЕ ENHANCEMENT #4 IS 
REM NOT NEEDED, BUT WILL 
REM GIVE BETTER RESULTS 
REM ТЕ INSTALLED. 


TEXT : HOME : CLEAR : PRINT 
: HTAB 08: PRINT "HIRES FAST 
BACKGROUND DEMO" 

HIMEM: 35583: REM PROTECT Е 

AST BACKGROUND.SET SPACE 


PRINT "BLOAD FAST BACKGROUND 
.SET": REM CTRL D 
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PROGRAM 8-2, CONT’D... 


POKE 35584,0: CALL 35585: REM 
HIDE THE HGR GLITCH 

НТАВ 6: PRINT "SHALL I ..... 
": PRINT : PRINT : PRINT 

HTAB 9: PRINT "(S) SHOW STOC 
K COLORS": PRINT 

HTAB 9: PRINT "(E) ENTER А М 
EW PATTERN": PRINT 

HTAB 9: PRINT "(R) CREATE RA 
NDOM PATTERNS": PRINT 

HTAB 9: PRINT "(Q) QUIT" 
PRINT : PRINT : HTAB 18: PRINT 
"€ >";: HTAB 19: REM PRINT 


IF AS = "S" THEN GOTO 


"Е" THEN GOTO 2000 
"R" THEN GOTO 3000 
чо" THEN PRINT : PRINT 
"RUN MENU": КЕМ EXIT 
PRINT "": REM DING-DING-DIN 
G 
HTAB 19: VTAB 19: GOTO 200: REM 
PICK MENU VALUE OR KEEP TR 
YING 
GOSUB 4000: HGR : REM GREY 
LORES FOR ERASE TIME 
VTAB 24: HTAB 5: PRINT "HIT 
ANY KEY TO RETURN TO MENU"; 


VTAB 22: HTAB 12: PRINT "HI 
RES COLOR #"; 

РОВ С = 0 TO 31: POKE 35584 
„С: HTAB 25: PRINT C;: CALL 
35585 

FOR М = 1 TO 2000: NEXT М: REM 

DISPLAY TIME 

IF PEEK ( - 16384) » 128 THEN 

POKE - 16368,0: GOTO 100 

РОВ М = 1 ТО 9:A = PEEK ( - 
16336): МЕХТ М: МЕХТ С: НТАВ 
25: PRINT " ";: GOTO 1030 
HGR : PRINT 
VTAB 21 

PRINT "ENTER DECIMAL PATTER 
N VALUES --": PRINT : PRINT 
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PROGRAM 8-2, CONT’D... 


2020 FOR N = 1 TO 8 

2030 УТАВ 23: HTAB 1: INPUT " "; 
AS(N):A(N) = VAL (AS(N)) 

2040 ae 24: HTAB (N * 4 + 2): PRINT 
А(М): 

2050 VTAB 23: НТАВ 1: PRINT " 

";; НТАВ 1: NEXT М 

2060 FOR М = 1 ТО 8: POKE 35839 + 
N,A(N): NEXT М 

2065 FOR N = 1 ТО 9:A = PEEK ( - 
16336): NEXT N 

2070 POKE 35584,0: CALL 35585 

2080 PRINT : VTAB 24: PRINT 

2085 PRINT : PRINT "<SPACE> NEW 
PATTERN <M> MENU < >"; 


2090 НТАВ 37: СЕТ А5 

2100 ТЕ A$ = " " THEN PRINT : PRINT 
: сото 2010 

2110 IF AS = "М" THEN СОТО 100 

2120 GOTO 2090 

3000 HGR : УТАВ 24: НТАВ 5: PRINT 
"HIT ANY KEY TO RETURN ТО МЕ 
NU"; 

3010 VTAB 22: HTAB 1: PRINT " 


- 
И 


3020 НТАВ 5: РОВ М = 1 ТО 8:А(М) 

= INT (256 * RND (1)): PRINT 
A(N);: PRINT " ";: POKE 3584 

O + N,A(N): NEXT N 

POKE 35584,0: CALL 35585: REM 
ENTER PATTERN ON SCREEN 

FOR N = 1 TO9:A = PEEK ( - 
16336): NEXT N 

FOR N = 1 TO 3000: NEXT N: REM 

DISPLAY TIME 

IF PEEK ( - 16384) > 128 THEN 
РОКЕ - 16368,0: GOTO 100 

GOTO 3010 

GR : COLOR= 5: FOR V = 0 TO 
39: HLIN 0,39 AT V: NEXT V: REM 
GREY LORES 

РОКЕ 35586,159: REM INVISI 
BLE SWITCH ON 

RETURN 

END 
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clear. Note that you can fake an indirect subroutine jump with a subroutine jump 
followed by a jump indirect command. 

Since there are lots of page Two options, we've purposely left them off the 
program to keep things simple. Add things on in any way that you like. 

If you watch the background color demo, with line 4010 omitted, you will 
notice a faint "boxwork' glitch as you change colors. This glitch is utterly 
insignificant when compared to the royal mess you got with the old HIRES clear, 
but it is there. 

There is an add-on to the FAST BACKGROUND.SET that totally eliminates this 
tiny remaining glitch for those of you who are program perfectionists. For this 
to work, you must have the field sync mod of Enhancement 4 in place and be 
willing to clear your text screen to LORES grey or some other suitable color. 

Fig. 8-5 shows us the flowchart of the “Invisible Switcher.” What this does 
is wait till a vertical blanking time, switches you to a perfect grey screen, does 
a new fast HIRES clear with the Backgrounder, waits for another blanking time, 
and, then, returns you to HIRES. Your eye sees only an instantaneous fade from 
one color through grey to another color, totally glitch free. 

If you do not have the field sync mod in place, delete or bypass line 4010 
of Program 8-2. Otherwise, the program may hang. 

To use the Invisible Switcher, just poke 35586,159 or enter $8B01 : 9F. Note 
that this invisible switcher is not for everyone, and it may in fact do more harm 
than good if you are always returning to the same background color. Neverthe- 
less, it's there for those of you who are antiglitch purists. The Invisible Switcher 
is included in the demo of Program 8-2. 


CONTENTS OF COMPANION 
PARTS KIT 


each 7415151 1/8 Selector IC. 
each 741502 Quad NOR Gate IC. 
each Tv clothespin connector. 
each Phono jack, upright pc type. 


each Spade lug, crimp style. 

each 4.7K resistor, 1/4 watt. 

each 16-pin DIP socket, premium 
machined-pin style. 

each 14-pin DIP socket, premium 
machined-pin style. 


each machined-pin socket contact. 

6 inches No. 22 stranded wire, red 
insulation. 

24 inches No. 24 solid wire, blue 

insulation. 

6 inches No. 24 solid wire, red 
insulation. 

12 inches Electronic solder. 


The parts kit costs $11.95 plus shipping and may be ordered using the at- 
tached card or directly бот... 
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PAIA Electronics 
Box 14359 
1020 West Wilshire 


Oklahoma City, OK 73114 
Tel: 405-842-5480 


CONTENTS OF COMPANION 
DISKETTE 


Auto Menu 

Color Killer Demo 

Field Sync Utility Subs.Source 
Field Sync Utility Subs 

Field Sync Quick Test 
VFFS.EMPTY.SOURCE 
VFFS.EMPTY 

VFFS.BOXES 


VFFS.GRAPH 
VFFS.GIRLS 
VFFS.BYE 
VFFS.LORES 


Fun With Mixed Fields 
LORES Colors 121 
LORES1 Create 
LORES2 Create 


LORES1 

LORES2 

Gentle Scroll Set.Source 
Gentle Scroll Set 


Gentle Scroll Tester 

Fast Background.Set.Source 
Fast Background.Set 

Fast Background Demo 


PLUS — Two mystery "bonus" 
programs! 


The 26-program DOS 3.3 diskette costs only $14.95. It is fully copyable for 
your personal use only and includes complete Apple Assembler source listings. 
The disk may be de-muffined or niffumed to DOS 3.2. All source listings and 
machine-language programs and modules are easily changed using the Apple 
Assembler provided on the DOS Toolkit. You can order this diskette using the 
attached card or directly Кот... 


SYNERGETICS 
Box 1300 
746 First Street 


Thatcher, AZ 85552 
Tel: 602-428-4073 
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In future volumes, we will be looking at lots of exciting new ways to add 
variable resolution color and grey scale to your Apple, and ways to do spinners, 
animation, and other partial screen scrolls. We will also do in the iron statue and 
the golden clockwork canary once and for all. See you there. 


PREVIEW OF VOLUME 2 


Here's a sampler of some of the exciting new stuff you'll find in Enhancing Your Apple Il, Vol- 
ume 2. 


DAISY DUMPERS - 
Some exceptionally high quality and very fast graphics screen dumps for daisywheel 
printers. You get sharp and solid lines with perfectly square corners. 


TEN-CENT FIX - 
A quick and easy modification of your cassette recorder that will dramatically increase 
reliability and ease of use. 


ADVENTURE EMERGENCY TOOLKIT - 
Do in the iron statue and the golden clockwork canary once and for all. Learn about the 
three ultra-challenging “hidden” adventures buried in ALL Adventure programs. 


SIX-WAY KEYBOARD IMPROVER - 
Simple and super cheap add-on hardware card that will give you auto repeat, shift key 
mod, external keypad, lap keyboard, key duration mode, and user-defined keys. Since it 
goes between the existing keyboard and the encoder, it’s compatible with all existing 
software. 


SHOW-N-TELL AUTO MENU - 
A very user-friendly menu system for noncomputer people. Show only what you want 
and where and how you want it, with full sound and animation. 


FAST AND EXACT FIELD SYNC - 
A low-cost hardware add-on that gives you an exact screen lock in any field. Does every- 
thing the mod of Enhancement 4 does, only it does it faster, simpler, and much more flex- 
ibly and conveniently. 


VIDEO SPLITS AND WIPES - 
Professional video special effects using fast exact field sync. You can smoothly wipe 
between screens or set up animated split-screen displays. 


ULTRASONIC BSR INTERFACE - 
A two-dollar hardware add-on that lets you control the world with your Apple by way of 
an ultrasonic link and a BSR controller. 


. . . , PLUS MUCH MORE! 


WE NEED YOUR HELP! 


A response card is included in the back. Please use it to tell us the best uses 
that you find for your mixed fields and the best HIRES background patterns that 
you found, along with any requests you have for future enhancements. This card 
will automatically register you for future corrections and updatesé 


IMPORTANT — For fastest service, 
please send each card to the right ad- 
dress. 


Parts kit orders go to PAIA. Everything 
else goes to SYNERGETICS. 


Sorry, no purchase orders or billing. We 
also cannot ship to a foreign address. 


Dealer inquiries invited. 


INDEX 


A Clock cycles, 91-93, 94, 107, 108-111 
Action files, 32-33 Code(s), 84 
Adaptor socket, 23 dead, 59 
Add-ons and modifications, 221-226 machine-language, 33, 37 
Address filter, 63-66 modules, 32, 107 
ALTFLD subroutine, 108, 112 pattern, 209-214 
Applesoft, 37, 39-41, 51, 96, 99, 121, 139, rational, 47, 48, 58, 59-60 
153, 154, 178-179 source, 34 

ASCII filter, 62-63 tearing into machine-language, 29-87 
Attack methods, 75 video display, 62 
Autocolor circuitry, 28 working, 32 
Autostart Color(s) 

monitor, 42, 46 background, 201-226 

reset, 18, 20, 24 band, 24-28 

ROM, 81 burst, 18, 19, 44, 93 

cell, 207-208, 209, 212 
B combinations, 205, 206-207 
complementary, 205, 206 

Background colors, 201-226 decoding circuits, 118 
Backup copies, 8 dots, 202-206, 207 
Bar graphs, 117, 121, 153 file, 214, 221 


Base addresses, 180, 182-185, 202 
BEDGE subroutine, 107, 112 
Breakpoints, 81, 82 

“Brute force" coding, 177 


HIRES, 207, 209 

killer 
automatic, 19 
programmable, 17-29 


Bugs, 35 : 
Bulk files, 32-33, 48-49, 61, 68-69, 75 what is?, 18 
lines, 18 
LORES, 209-210 
c pastel, 212-213 
Cell, color, 207-208, 209, 212 patterns, 208, 210-211 
Chain, timing, 92 shifted and unshifted, 203-206 
Change detection, 83-84 Complementary colors, 205, 206 
Changeover switch, 10, 11-12 Control commands, software, 18 
Character display, 172 CRUDE, 99, 107, 112, 175 
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Dead code, 59, 87 
Debug programs, 31 
Decoding circuits, color, 18 
Delay subroutine, 110 
Demo programs, 152, 153 
Diagnostic helps, 81 
Disassembler, 87 
Display 
code, video, 62 
file, 118 
Documentation, 8, 34 
DOS, 38-39, 44, 51, 67, 82 
file, 38-39 
hooks, 38, 178 
Dot(s) 
color, 202-206, 207 
patterns, 209-213 
positions, 204-205 
Dummy soft switches, 139, 144 


Edge detector, 107 
Exact sync, 108-111, 112 


F 


FEDGE subroutine, 107-108, 110, 112 
Field(s) 
alternator, 108, 115 
mixed, 117-144 
rate timing, 91 
switch modification, 96-98 
switching, 118 
sync, 89-115, 175 
modification, 173, 175, 196, 226 
File(s) 
action and bulk, 32-33 
bulk, 48—49, 61, 68-69 
color, 214, 221 
design, 144 
display, 118 
filters, 60-61, 67, 69 
flag, 66-67 
locations, 144 
working, 121-144 
Filter 
address, 63-66 
ASCII, 62-63 
file, 60-61, 67, 69 
stash, 60-61, 63 
Flag file, 66-67 
Force feeder, 83 
Full-color mixed graphics, 18 


G 


Garbage, 8, 59, 90 
Gentle scroll, 171-200 
flowchart, 186 
program, 178, 179, 180, 185, 187-193 
Glitch(es), 160, 161, 201, 202, 226 
riddance, 150-151 


Glitch(es) —cont 
stomper, 150, 151, 159-169 
Glomper(s) 
of the first kind, 12-14 
of the second kind, 14-16 
two, 10, 11-16 
Graph, 153 
Graphics, 38, 90, 108, 112, 138, 160 
full-color mixed, 18 


H 


Hardware, 159-160, 172 
color killer, 19, 24-28 
modifications, 10, 89, 159, 162-163, 196 
Hex dumps, 152-153, 154, 194 
High 
memory pointer; see HIMEM 
RAM, 35, 38-39 
— Resolution Character Generator; see 
HRCG 
HIMEM, 39-41, 99, 121 
pointer, 178, 179 
HIRES, 9, 10, 17, 19, 24, 37, 38, 90, 112, 
117, 178 
base addresses, 66 
colors, 150, 159, 207, 209 
demo program, 152 
display, 153 
graphics, 66, 196 
screen(s), 66, 75, 153 
pages, 33 
subroutines, 180, 201 
utility, 201 
Hook(s), 36, 59, 81 
DOS, 178 
programs, 32 
scroll, 35, 85 
Horizontal 
patterns, 136-137, 139 
— rate timing, 91, 92-93 
scan lines, 119-120, 147 
sync pulse, 92, 93 
HRCG, 33-35, 44, 46, 48, 62, 75-76, 99, 
172, 178-179, 202 
Hues, 207, 210, 212-213 


Integer BASIC, 37, 39-41, 51, 121 
МО sockets, 7, 27 
Irrational code, 58 


Keyboard 
buffer, 37, 38, 43, 178 
entry hooks, 36 
strobe, 41—42 


L 


Light pens, 89, 90, 95, 108, 111 
Logic analyzer, 83 


LOMEM, 39-41, 99 

Loops, 58, 176-177 

LORES, 9, 10, 17, 19, 37, 38, 90, 117, 178 
colors, 153-154, 158, 209-210 

Low 
- memory pointer; see LOMEM 
RAM, 35-38 

Luminance video, 93 


M 


Machine-language 
code, 33, 37, 138, 200 
tearing into, 29-87 
programs, 30, 32, 41, 43-44, 49, 121 
subroutine, 96, 171, 214 
Machined-pin contacts, 23 
Master timing reference, 91 
Memory 
map, 178-185 
mapping, 35 
Mixed 
fields, 117-144, 158, 159, 175 
graphics, 18, 19 
Modification(s), 19-20, 144, 150, 221-226 
hardware, 10, 26 
field-switch, 96-98 
field sync, 95-98, 173, 175 
Modulator, rf, 10, 11-12, 16, 28 
Monitor(s), 42, 46, 51, 81, 82 
system, 8 
Motion perception, 173-174 
Multiplexer, 91 
Music synthesizer card, 16 


Р 
Partial boot, 83 ` 
Pastel colors, 212-213 
Pattern(s) 


codes, 209-214 
color, 208, 210-211 
dots, 209-213 
Print output hooks, 36 
Program(s) 
bugs, 35 
gentle scroll, 178, 179, 180, 185, 
187-193 
hook, 32 
locations, 44-46, 51-56 
machine-language, 30, 32, 34, 41, 43-44, 
49, 121 
structure, 33 
test and debug, 31 
Programmable color killer, 17-29 
Programming, machine-language, 30-31 


R 


RAM 
high, 35, 38-39 
low, 35-38 
user, 46 
Raster scan collisions, 174-176 


Index 231 


Rational code, 47, 48, 58, 59-60 
Relocatable programs, 58, 178 
Remapping, 173, 176-178, 180-181, 194 
Reset, autostart, 18, 20, 24 

Rf modulator, 10, 11-12, 16, 28 


5 


Scan lines, 145, 147, 151, 207, 211, 
212-213, 214 
horizontal, 119-120 
Screen switches, 41-42 
Script, 75-76 
Scroll, 35, 83, 171, 174 
gentle, 90 
hooks, 35, 85 
subroutine, 85 
Shape table, 66 
Shifted colors, 203-206, 210 
Signal, black and white, 18 
Socket(s) 
adaptor, 23 
ПО, 7, 27 
Soft switch, 118-119, 121, 138-139, 143, 
158 
Software, 8, 108, 159-160, 172 
color killer, 19, 23-24, 28 
control commands, 18 
support, 96-115, 117 
Source code, 34 
Split screens, 89 
Sprite maps, 66 
Stack, 37 
Start-of-program pointer, 41 
Stash filter, 60-61, 63 
Stashes, 32-33, 37, 59-60, 75 
Strobe, keyboard, 41-42 
Subroutine(s), 33, 49-51, 56, 64-65, 81, 
82, 99, 107-108, 111, 149, 222, 
226 
HIRES, 201 
machine-language, 96, 171, 214 
scroll, 85 
Support software, 96-115, 117 
Switch, changeover, 10, 11-12 
System monitor, 8 


Tearing 
attack method, 34, 35 
into machine-language code, 29-87 
Test and debug programs, 31 
Text displays, 38 
Timing 
chain, 92, 94 
reference, master, 91 
video, 91 
waveforms, 91-95 
Two glompers, 10, 11-16 
TXTAB; see start-of-program pointer 
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U Video —cont 
Unshifted colors, 203-206, 210 Field Formatter Sub, 121; see a/so VFFS 
Utility i ! glitch-free, 91 
HIRES, 201 Іштіпапсе, 93 
subs, 96 timing, 91, 179 
v . w 
Vertical rate timing, 93 Warranty, 23 
VFFS, 121-149 Working 
Video code, 32 


display code, 62 files, 121-144 
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